Lập trình script cho các thành phần đồ họa
Sơ lược
- Tìm hiểu cách tạo biểu mẫu script và thêm các điều khiển từ bảng Tool Palette.
- Khám phá cách kiểm tra thuộc tính, tìm phương thức và tạo trình xử lý sự kiện cho các tương tác của người dùng.
- Nắm rõ các thiết lập chi phối giao diện biểu mẫu, hành vi cửa sổ, thao tác nhập bằng bàn phím và tiêu điểm ban đầu.
Tài liệu tham khảo này trình bày các thành phần đồ họa được hỗ trợ khi viết script cùng các thuộc tính và phương thức chính của chúng.
Các thành phần biểu mẫu trực quan có thể sử dụng trong script của Altium Designer chủ yếu được kế thừa từ Visual Component Library (VCL) của Embarcadero, một tập hợp các thành phần trực quan được định nghĩa sẵn để phát triển ứng dụng Windows bằng ngôn ngữ Delphi và C++.
Được phát triển dưới dạng thư viện lớp trực quan, các lớp VCL kế thừa từ đối tượng TComponent (bản thân đối tượng này kế thừa từ đối tượng gốc TObject) theo hệ phân cấp đối tượng tuyến tính. Vì vậy, một thành phần script thông dụng, chẳng hạn như đối tượng TButton, sẽ kế thừa các thuộc tính, phương thức và sự kiện từ các đối tượng cấp trên. Trong trường hợp này, hệ phân cấp lớp là: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.
Lưu ý rằng các thành phần kế thừa từ đối tượng TControl thường là các thành phần trực quan (điều khiển), còn các thành phần thông dụng kế thừa từ TWinControl chủ yếu là các lớp bao bọc Windows API.
► Xem Embarcadero RAD Studio VCL để biết tổng quan về kiến trúc và các thành phần VCL.
Khi tạo Biểu mẫu trong Trình soạn thảo script của Altium Designer, bạn có thể truy cập các thành phần từ bảng Tool Palette. Mỗi Biểu mẫu script có một tệp *.DFM đi kèm, chứa thông tin chi tiết về cấu hình biểu mẫu, vị trí các thành phần và các thuộc tính khác – tệp này nằm trong thư mục chứa dự án script. Altium Designer cho phép sử dụng các thành phần bằng DelphiScript hoặc VBScript khi thiết kế Biểu mẫu script.

Bảng Tool Palette chứa các điều khiển trực quan được phân loại, có thể kéo thả vào Biểu mẫu script.
Bảng Tool Palette chứa các nhóm thành phần được phân loại, có thể đặt lên Biểu mẫu script. Các thành phần khả dụng được tập hợp thành những mục có thể mở rộng trong bảng Tool Palette, được phân loại thành Standard, Additional, Win32, System, Dialogs, Altium Standard và Instrument Controls.
Các thành phần (hay “điều khiển”) có trong Palette là các thành phần trực quan khi được sử dụng trên biểu mẫu script, nghĩa là người dùng có thể nhìn thấy điều khiển và có thể tương tác với nó khi chạy. Tất cả các điều khiển đều có các thuộc tính, phương thức và sự kiện mô tả những khía cạnh về giao diện và hoạt động của chúng, chẳng hạn như thuộc tính vị trí của điều khiển, các phương thức để vẽ hoặc di chuyển điều khiển, và các sự kiện phản hồi thao tác của người dùng.
Các thuộc tính và sự kiện của thành phần biểu mẫu hiện được chọn, bao gồm cả chính biểu mẫu, có trong bảng Object Inspector. Các phương thức là những thủ tục và hàm được thành phần đó hỗ trợ.
Tổng quan về Biểu mẫu script
Biểu mẫu script
Biểu mẫu script là giao diện người dùng chính trong script, mặc dù còn có các dạng giao diện khác như hộp thoại, cửa sổ phụ, v.v. Để tạo Biểu mẫu script mới, khi một dự án đang mở trong Altium Designer, hãy chọn File » New » Script » Script Form hoặc nhấp chuột phải vào tên dự án script rồi chọn Add New to Project » Script Form. Nếu ngôn ngữ VBScript được bật, lệnh này sẽ khả dụng cho cả VB Script và Delphi Script.
Một Biểu mẫu script mới xuất hiện với tên biểu mẫu mặc định là Form1. Bạn có thể thay đổi tên này thông qua thuộc tính Name (trong Misc) ở bảng Object Inspector. Tên các biểu mẫu script trong cùng một dự án phải khác nhau.
Khi thiết kế Biểu mẫu script, hãy mở bảng Object Inspector từ nút Script trên thanh trạng thái phía dưới.
Về cơ bản, biểu mẫu trống là một cửa sổ trực quan mà bạn có thể thêm các điều khiển vào. Hộp thoại và bảng là những loại biểu mẫu khác nhau, và theo mặc định, biểu mẫu có các chức năng cửa sổ tiêu chuẩn như:
- Các điều khiển
- Các nút Thu nhỏ và Phóng to
- Thanh tiêu đề
- Thay đổi kích thước bằng cách kéo đường viền
Có thể thay đổi các tính năng này cùng mọi thuộc tính biểu mẫu khả dụng khác trong quá trình thiết kế bằng bảng Object Inspector. Vì Biểu mẫu script là một thành phần VCL nên nó có ba yếu tố sau:
-
Properties – Các đặc điểm của đối tượng ảnh hưởng đến hành vi hiển thị hoặc hoạt động của đối tượng đó. Ví dụ, thuộc tính
Visiblexác định liệu một đối tượng có hiển thị trên biểu mẫu script hay không. - Events – Các hành động hoặc sự việc được script phát hiện. Script phải có mã cho từng trình xử lý sự kiện, được thiết kế để tiếp nhận một sự kiện cụ thể, chẳng hạn như nhấp chuột.
- Methods – Các thủ tục script được liên kết với các đối tượng (trong trường hợp này là các đối tượng thành phần) và xác định hành vi của chúng.
► Xem Viết script để biết hướng dẫn cơ bản về cách phát triển script dựa trên biểu mẫu.
Thuộc tính, phương thức và sự kiện của biểu mẫu
Các điều khiển trong bảng Tool Palette dựa trên Visual Component Library (VCL) của Embarcadero. Để biết đầy đủ thông tin về các phương thức, thuộc tính và sự kiện của thành phần Form (TForm), hãy tham khảo tài liệu VCL của Embarcadero.
► Xem Tài liệu tham khảo TForm của Embarcadero
Thuộc tính của TForm
Có thể xem các thuộc tính khả dụng của đối tượng thành phần TForm, biểu mẫu script cơ sở, theo những cách sau:
- Thông qua bảng Object Inspector – Trong chế độ xem Biểu mẫu của trình soạn thảo (chọn thẻ Form ), nhấp vào phần thân của chính biểu mẫu rồi chọn thẻ Object Inspector's Properties .
Lưu ý rằng chỉ các đối tượng thành phần trực quan mới xuất hiện trong bảng. Các đối tượng phi trực quan, đóng vai trò điều khiển ngầm, không được hiển thị trên biểu mẫu.
- Sử dụng tính năng Hoàn thành mã – Trong chế độ xem Mã của trình soạn thảo (chọn thẻ Code ), cửa sổ Hoàn thành mã theo ngữ cảnh sẽ hiển thị tất cả các tùy chọn mã cho một tên đối tượng.
Đối với đối tượng Form, nhập TForm. (lưu ý dấu chấm) để kích hoạt cửa sổ. Thu hẹp tìm kiếm bằng cách nhập vài chữ cái đầu của thuộc tính mong muốn – lưu ý rằng cả thuộc tính và phương thức đều được hiển thị.
- Từ tài liệu tham khảo của Embarcadero trên trang tham khảo Thuộc tính của TForm.
Phương thức của TForm
Có thể xem các phương thức khả dụng của đối tượng thành phần TForm theo những cách sau:
- Sử dụng tính năng Hoàn thành mã – Trong chế độ xem Mã của trình soạn thảo, nhập tên thành phần theo sau là dấu chấm. Cửa sổ Hoàn thành mã sẽ mở ra để hiển thị các phương thức (và thuộc tính) trong mã cho một tên đối tượng. Lưu ý rằng có thể kích hoạt cửa sổ mã theo cách thủ công bằng tổ hợp phím tắt Crtl+Space.
- Tham khảo tài liệu của Embarcadero trên trang tham khảo Phương thức của TForm. Lưu ý rằng trang này hiển thị tất cả các phương thức được kế thừa, tuy nhiên có thể bỏ chọn tùy chọn đó.
Sự kiện của TForm
Có thể xem các sự kiện khả dụng của đối tượng thành phần TForm theo những cách sau:
- Bảng Object Inspector – Trong chế độ xem Biểu mẫu của trình soạn thảo, nhấp vào phần thân của chính biểu mẫu rồi chọn thẻ Events của Object Inspector.
- Tài liệu tham khảo của Embarcadero trên trang tham khảo Sự kiện của TFrom.
Thuộc tính, sự kiện và phương thức của thành phần
Các điều khiển trong bảng Tool Palette dựa trên Thư viện Thành phần Trực quan (VCL) của Embarcadero. Để biết đầy đủ thông tin về các phương thức, thuộc tính và sự kiện của phần lớn các thành phần, hãy tham khảo các danh mục thành phần trong tài liệu Embarcadero VCL. Một số loại thành phần trong Tool Palette, đặc biệt là Altium Instrument Controls, chỉ có trong Altium Designer và không được đề cập trong tài liệu tham khảo của Embarcadero.
► Xem Chỉ mục danh mục thành phần Embarcadero VCL
Thuộc tính của thành phần
Để xem danh sách thuộc tính của một thành phần:
-
Chọn một thành phần trên biểu mẫu và kích hoạt thẻ Properties trong bảng Object Inspector – như minh họa ở trên cho đối tượng thành phần
TForm. -
Chọn liên kết Properties (ở trên cùng) trên trang tham khảo của thành phần tương ứng trong tài liệu tham khảo Embarcadero. Ví dụ, với điều khiển
TButton, hãy chọn danh mục Thành phần tiêu chuẩn, trang TButton, rồi đến chế độ xem Thuộc tính.
Sự kiện của thành phần
Để xem danh sách sự kiện mà một thành phần có thể phản hồi:
-
Chọn một thành phần trên biểu mẫu và kích hoạt thẻ Events trong bảng Object Inspector – như minh họa ở trên cho đối tượng thành phần
TForm. - Chọn trang tham khảo của thành phần tương ứng, rồi chọn liên kết Events trên trang đó trong tài liệu tham khảo Embarcadero. Lưu ý rằng thông tin này hữu ích để tham khảo các sự kiện có sẵn cho một thành phần, nhưng có thể không hoàn toàn khớp với các sự kiện có sẵn cho các thành phần lập trình kịch bản của Altium Designer.
Để tạo thủ tục xử lý sự kiện, hãy chọn sự kiện mà thành phần cần phản hồi trong thẻ Object Inspector Events, rồi nhấp đúp vào trường nhập sự kiện. Thủ tục xử lý sự kiện, được đặt tên theo thành phần và hành động của sự kiện, sẽ tự động được tạo trong tập lệnh. Nếu đổi tên sự kiện trong bảng Object Inspector, thủ tục mã tương ứng cũng sẽ được đổi tên theo.
Phương thức của thành phần
Tham khảo tài liệu Danh mục thành phần để biết thông tin về các phương thức có sẵn cho thành phần Tool Palette.
Tài liệu này bao gồm thông tin tham khảo cho các danh mục đối tượng điều khiển sau.
- Tiêu chuẩn
- Bổ sung
- Win32
- Hệ thống
- Hộp thoại
- Tiêu chuẩn Altium
- Điều khiển thiết bị đo
Phần lớn các danh mục này tập hợp các loại điều khiển trực quan trên biểu mẫu dựa trên các thành phần VCL kiểu Delphi tiêu chuẩn. Các danh mục Tiêu chuẩn Altium và Điều khiển thiết bị đo là ngoại lệ vì chúng cung cấp các thành phần chỉ có trong hệ thống lập trình kịch bản của Altium Designer.
► Xem Tool Palette Danh mục thành phần.
Làm việc với biểu mẫu và thành phần
Tùy chỉnh biểu mẫu tập lệnh
-
Ví dụ, để biểu mẫu luôn nằm trên các bảng đang mở khác, hãy đặt thuộc tính
FormStylethànhfsStayOnTop. -
Để xác định hành vi mặc định của biểu mẫu, hãy đặt
FormKindthành một trong các giá trị sau:fkNone, fkNormal, fkServerPanelhoặcfkModal.-
Nếu chọn
fkModal, biểu mẫu sẽ là biểu mẫu dạng modal. Nghĩa là biểu mẫu sẽ chờ người dùng nhập dữ liệu trước khi tiếp tục thực hiện các hành động như đóng biểu mẫu. -
Nếu chọn
fkServerPanel, biểu mẫu sẽ được hiển thị dưới dạng bảng Server. -
Nếu chọn
fkNormal, biểu mẫu sẽ hoạt động như một biểu mẫu không modal thông thường.
-
Nếu chọn
-
Để thêm/xóa thanh cuộn của biểu mẫu, hãy thay đổi giá trị của các thuộc tính
HorzScrollBarvàVertScrollBar. -
Để đặt biểu mẫu làm khung hoặc cửa sổ con MDI (Giao diện nhiều tài liệu), hãy sử dụng thuộc tính
FormStyle. -
Để thay đổi kiểu đường viền của biểu mẫu, hãy sử dụng các thuộc tính
BorderIconsvàBorderStyle. (Kết quả hiển thị khi chạy.) -
Để thay đổi biểu tượng của biểu mẫu khi thu nhỏ, hãy sử dụng thuộc tính
Icon. -
Để chỉ định vị trí ban đầu của biểu mẫu trong cửa sổ ứng dụng, hãy sử dụng thuộc tính
Position. -
Để chỉ định trạng thái ban đầu của biểu mẫu (ví dụ: thu nhỏ, phóng to hoặc bình thường), hãy sử dụng thuộc tính
WindowState. -
Để xác định vùng làm việc của biểu mẫu khi chạy, hãy sử dụng các thuộc tính
ClientHeightvàClientWidth. Lưu ý rằngClientHeightvàClientWidthbiểu thị vùng bên trong đường viền của biểu mẫu, cònHeightvàWidthbiểu thị toàn bộ diện tích của biểu mẫu. -
Để chỉ định điều khiển được lấy tiêu điểm ban đầu trên biểu mẫu khi chạy, hãy sử dụng thuộc tính
ActiveControlđể chọn trong số các thành phần có sẵn. -
Để chuyển tất cả sự kiện bàn phím đến biểu mẫu, bất kể điều khiển nào đang được chọn, hãy sử dụng thuộc tính
KeyPreview. -
Để chỉ định một menu cụ thể khi biểu mẫu có nhiều menu, hãy sử dụng thuộc tính
Menu.
Làm mới biểu mẫu và thành phần
Trong một số trường hợp, phần hiển thị của biểu mẫu tập lệnh có thể không được cập nhật. Ví dụ, khi tập lệnh thực hiện xử lý nền nặng khiến các điều khiển không được cập nhật hoặc vẽ lại, chúng có thể trông như bị treo hoặc hiển thị sai.
Phương thức Update của biểu mẫu tập lệnh cho phép làm mới nội dung đồ họa của biểu mẫu hoặc các điều khiển cụ thể bằng mã. Trong ví dụ mã bên dưới, các dòng mã của phương thức Update được tô nền xám.
Using the Update method to refresh the Status Bar:
Procedure TConverterForm.loadbuttonClick(Sender: TObject);
Var
I, J : Integer;
Begin
If OpenPictureDialog1.Execute then
Begin
XPProgressBar1.Position := 0;
XStatusBar1.SimpleText := ' Loading...';
XStatusBar1.Update;
// loading a monochrome bitmap only
Image1.Picture.LoadFromFile(OpenPictureDialog1.FileName);
// Check if image is monochrome, otherwise prompt a warning
If Image1.Picture.Bitmap.PixelFormat <> pf1bit Then
Begin
For J := 0 to Image1.Picture.Height – 1 Do
For I := 0 to Image1.Picture.Height – 1 Do
Begin
If Image1.Canvas.Pixels[I,J] <> clWhite Then
Image1.Canvas.Pixels[I,J] := clBlack;
End;
End;
ScalingFactorChange(Nil);
convertbutton.Enabled := True;
LoadButton.Enabled := False;
XStatusBar1.SimpleText := ' Ready...';
XStatusBar1.Update;
End;
End;
Tham khảo dự án tập lệnh PCB Logo Creator nằm trong thư mục Scripts\Delphiscript Scripts\PCB\PCB Logo Creator của bộ sưu tập tập lệnh có thể tải xuống.



