Biểu mẫu & Linh kiện
Sơ lược
- Hiểu cách các thuộc tính, sự kiện và phương thức của thành phần phối hợp với nhau.
- Học cách thêm thành phần và cấu hình trình xử lý sự kiện bằng các bảng Tool Palette và Object Inspector.
- Khám phá các ví dụ về cách hiển thị biểu mẫu dạng modal, kiểm tra dữ liệu nhập trống và kiểm soát hành vi của biểu mẫu.
Tổng quan về các thành phần đồ họa
Hệ thống viết script xử lý hai loại thành phần: thành phần trực quan và thành phần phi trực quan.
Các thành phần trực quan được dùng để xây dựng giao diện người dùng, còn các thành phần phi trực quan được dùng cho những tác vụ khác nhau, chẳng hạn như các thành phần Timer, OpenDialog và MainMenu.
-
Thành phần phi trực quan
Timercó thể được dùng để kích hoạt đoạn mã cụ thể theo các khoảng thời gian đã lên lịch và người dùng sẽ không bao giờ nhìn thấy thành phần này. -
Các thành phần
Button,EditvàMemolà các thành phần trực quan.
Cả hai loại thành phần đều xuất hiện trong quá trình thiết kế, nhưng các thành phần phi trực quan sẽ không hiển thị khi chạy. Các thành phần trong bảng Tool Palette có tính hướng đối tượng và có ba yếu tố sau:
- Thuộc tính
- Sự kiện
- Phương thức
Property là một đặ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 Visible xác định đối tượng này có hiển thị trên biểu mẫu script hay không.
Event là một hành động hoặc sự việc được script phát hiện. Trong script, lập trình viên viết 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ư thao tác nhấp chuột.
Method là một thủ tục luôn gắn với một đối tượng và xác định hành vi của đối tượng đó.
Tất cả các biểu mẫu script đều có một hoặc nhiều thành phần. Các thành phần thường hiển thị thông tin hoặc cho phép người dùng thực hiện một hành động. Ví dụ: Label được dùng để hiển thị văn bản tĩnh, hộp Edit được dùng để cho phép người dùng nhập dữ liệu, còn Button có thể được dùng để khởi chạy các hành động.
Có thể đặt bất kỳ tổ hợp thành phần nào lên biểu mẫu và trong khi script đang chạy, người dùng có thể tương tác với bất kỳ thành phần nào trên biểu mẫu. Nhiệm vụ của lập trình viên là quyết định điều gì sẽ xảy ra khi người dùng nhấp vào một nút hoặc thay đổi văn bản trong hộp Edit.
Hệ thống viết script cung cấp nhiều thành phần có thể được dùng để tạo các giao diện người dùng phức tạp cho script. Để đặt một thành phần lên biểu mẫu, hãy tìm biểu tượng của thành phần đó trên bảng Tool Palette rồi nhấp đúp vào biểu tượng. Thao tác này đặt một thành phần lên biểu mẫu đang hoạt động. Hình thức hiển thị của hầu hết các thành phần được thiết lập thông qua các thuộc tính của chúng. Ban đầu, thành phần được đặt tại vị trí mặc định trên biểu mẫu nhưng có thể được di chuyển (kéo) và thay đổi kích thước (kéo giãn) theo nhu cầu. Bạn cũng có thể thay đổi kích thước và vị trí sau đó bằng bảng Object Inspector .
Khi một thành phần được thả vào biểu mẫu, hệ thống viết script sẽ tự động tạo mã cần thiết để sử dụng thành phần đó và cập nhật biểu mẫu script. Bạn chỉ cần thiết lập các thuộc tính và triển khai mã xử lý sự kiện để sử dụng các phương thức mong muốn, qua đó giúp thành phần trên biểu mẫu hoạt động.
Thiết kế biểu mẫu script
Biểu mẫu script được thiết kế để tương tác với người dùng trong môi trường làm việc. Thiết kế biểu mẫu script là phần cốt lõi của quá trình phát triển trực quan.
Trong thực tế, tất cả các thành phần đều được đặt trên một biểu mẫu script và mỗi thuộc tính được thiết lập đều được lưu trong một tệp mô tả biểu mẫu (tệp *.DFM), có mối liên hệ với mã script liên quan (tệp *.PAS). Mỗi biểu mẫu script đều có tệp .PAS và tệp .DFM tương ứng.
Khi làm việc với biểu mẫu script và các thành phần của nó, bạn có thể kiểm tra và sửa đổi tất cả các thuộc tính của phần tử bằng bảng Object Inspector. Bạn có thể chọn nhiều thành phần bằng cách giữ phím Shift rồi nhấp vào các thành phần hoặc kéo một hình chữ nhật chọn bao quanh các thành phần trên biểu mẫu. Biểu mẫu script có một tiêu đề (thuộc tính Caption trên bảng Object Inspector).
Tạo biểu mẫu script mới
Khi một dự án script đang mở, hãy nhấp chuột phải vào dự án trong bảng Projects, nhấp vào mục Add New to Project trong menu ngữ cảnh bật lên rồi chọn mục Delphi Script Form. Một biểu mẫu script mới sẽ mở ra với tên mặc định là EditScript1.pas.
Hiển thị biểu mẫu script
Script cần có một thủ tục để hiển thị biểu mẫu khi biểu mẫu script được thực thi. Trong thủ tục này, có thể gọi phương thức ShowModal cho biểu mẫu. Thuộc tính Visible của biểu mẫu cần được đặt thành false để phương thức ShowModal của biểu mẫu script hoạt động chính xác.
ShowModal example:
Procedure RunDialog;
Begin
DialogForm.ShowModal;
End;
Ví dụ ShowModal là một cách rất đơn giản để hiển thị biểu mẫu script khi thủ tục RunDialog được gọi. Lưu ý rằng có thể gán giá trị cho các thành phần của đối tượng DialogForm trước khi gọi phương thức DialogForm.ShowModal.
Ví dụ về thuộc tính ModalResult bên dưới phức tạp hơn một chút. Các phương thức sau trong script được dùng cho các nút trên biểu mẫu script. Các phương thức này khiến hộp thoại kết thúc khi người dùng nhấp vào nút OK hoặc Cancel, theo đó phương thức ShowModal trả về giá trị tương ứng là mrOk hoặc mrCancel.
ModalResult Example:
Procedure TForm.OKButtonClick(Sender: TObject);
Begin
ModalResult := mrOK;
End;
Procedure TForm.CancelButtonClick(Sender: TObject);
Begin
ModalResult := mrCancel;
End;
Procedure RunShowModalExample;
Begin
// Form's Visible property must be false for ShowModal to work correctly.
If Form.ShowModal = mrOk Then ShowMessage('mrOk');
If Form.ShowModal = mrCancel Then ShowMessage('mrCancel');
End;
Khi người dùng nhấp vào một trong hai nút trên biểu mẫu script này, hộp thoại sẽ đóng. Không cần gọi phương thức Close, vì khi phương thức ModalResult được thiết lập, bộ máy thực thi script sẽ tự động đóng biểu mẫu script.
Lưu ý rằng nếu bạn muốn đặt ModalResult của biểu mẫu thành Cancel khi người dùng nhấn phím Esc , hãy dùng bảng Object Inspector để đặt thuộc tính Cancel của nút Cancel thành True, hoặc chèn Sender.Cancel := True vào trình xử lý sự kiện CancelButtonClick của nút trên biểu mẫu.
Tiếp nhận dữ liệu nhập từ người dùng
Một trong những thành phần phổ biến có thể tiếp nhận dữ liệu nhập từ người dùng là thành phần TEdit. Thành phần này có một trường để người dùng nhập một chuỗi ký tự. Lưu ý rằng còn có các thành phần Delphi khác như TMaskEdit, là một thành phần chỉnh sửa có mặt nạ nhập liệu được lưu trong một chuỗi — mặt nạ này kiểm soát hoặc lọc dữ liệu đầu vào.
Ví dụ bên dưới minh họa quá trình diễn ra khi người dùng nhấp vào nút sau khi nhập nội dung vào hộp chỉnh sửa. Nếu người dùng không nhập gì vào thành phần chỉnh sửa (để trống), trình xử lý sự kiện sẽ phản hồi bằng một thông báo cảnh báo.
Procedure TScriptForm.ButtonClick(Sender : TObject);
Begin
If Edit1.Text = '' Then
Begin
ShowMessage('Warning - empty input!');
Exit;
End;
// do something else for the input
End;
Lưu ý rằng người dùng có thể chuyển tiêu điểm nhập liệu của hộp thoại bằng phím Tab hoặc bằng cách nhấp vào một điều khiển khác trên biểu mẫu.
Phản hồi sự kiện
Khi người dùng nhấp vào một nút trên biểu mẫu hoặc một thành phần, hệ thống viết script sẽ phản hồi bằng cách nhận thông báo sự kiện từ Altium Designer và gọi phương thức xử lý sự kiện thích hợp.
See also
Dự án HelloWorld trong thư mục Scripts\DelphiScript Scripts\General\ thuộc bộ sưu tập script.
Script ví dụ ShowModal trong thư mục Scripts\DelphiScript Scripts\General\ thuộc bộ sưu tập script.
Viết trình xử lý sự kiện
Mỗi thành phần trong một script biểu mẫu có một tập hợp tên sự kiện. Các tên này được dùng bởi các trình xử lý sự kiện của script để xác định cách script phản hồi các thao tác của người dùng trong Altium Designer. Ví dụ, khi người dùng nhấp vào một nút trên biểu mẫu, Altium Designer gửi một thông báo đến script và script phản hồi sự kiện mới này. Nếu sự kiện OnClick của nút đã được chỉ định, sự kiện đó sẽ được thực thi.
Mã phản hồi các sự kiện thường nằm trong các trình xử lý sự kiện DelphiScript, và mọi thành phần đều có một tập hợp sự kiện mà chúng có thể phản hồi. Ví dụ, tất cả các thành phần có thể nhấp đều có sự kiện OnClick, được kích hoạt khi người dùng nhấp vào thành phần đó. Tất cả các thành phần này cũng có sự kiện khi nhận và mất tiêu điểm. Tuy nhiên, nếu chưa chỉ định mã cho OnEnter và OnExit (OnEnter - điều khiển đã nhận tiêu điểm; OnExit - điều khiển đã mất tiêu điểm), script sẽ bỏ qua sự kiện đó.
Tóm lại, sự kiện là mối liên kết giữa một hành động xảy ra trong Altium Designer, chẳng hạn như nhấp vào nút, và một đoạn mã phản hồi hành động đó. Đoạn mã phản hồi được gọi là trình xử lý sự kiện. Mã này thay đổi các giá trị thuộc tính và gọi các phương thức.
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, hãy chọn thành phần đó và mở tab Properties trong bảng Object Inspector.
Sự kiện của thành phần
Để xem danh sách các sự kiện mà một thành phần có thể phản hồi, hãy chọn thành phần đó và mở tab Events trong bảng Object Inspector. Để tạo một thủ tục xử lý sự kiện, hãy chọn sự kiện mà bạn muốn thành phần phản hồi và nhấp đúp vào tên sự kiện — hệ thống viết script sẽ tự động chèn mã khung cho trình xử lý sự kiện.
Ví dụ, chọn thành phần TButton từ bảng Tool Palette và thả vào biểu mẫu script, sau đó nhấp đúp vào bên cạnh tên sự kiện OnClick trong bảng Object Inspector . Hệ thống viết script sẽ chuyển tiêu điểm sang Trình soạn thảo mã và tạo mã khung cho sự kiện OnClick.
Ví dụ, nếu một nút có phương thức Close trong trình xử lý sự kiện CloseClick, khi nhấp vào nút, trình xử lý sự kiện của nút sẽ bắt sự kiện OnClick, khiến mã bên trong trình xử lý sự kiện được thực thi. Kết quả là phương thức Close sẽ đóng biểu mẫu script.
Tóm lại, hãy chọn một thành phần nút trên biểu mẫu hoặc thông qua bảng Object Inspector, chọn trang Events, rồi nhấp đúp vào phía bên phải của sự kiện OnClick; một trình xử lý sự kiện mới sẽ xuất hiện trong script. Ngoài ra, bạn có thể nhấp đúp vào chính nút đó và hệ thống viết script sẽ thêm trình xử lý cho sự kiện OnClick này. Lưu ý rằng các loại thành phần khác sẽ có các hành động mặc định khác nhau.
Phương thức của thành phần
Để xem danh sách phương thức của một thành phần, hãy xem tài liệu Tham khảo về thành phần.
Thả thành phần vào biểu mẫu script
Để sử dụng các thành phần từ bảng Tool Palette trong một script, cần có sẵn biểu mẫu script trước khi có thể thả các thành phần vào biểu mẫu. Thông thường, khi thả các thành phần vào biểu mẫu script, bạn không cần tạo hoặc hủy các đối tượng này — biểu mẫu script sẽ tự động thực hiện việc đó.
Hệ thống viết script cũng tự động tạo mã cần thiết để sử dụng thành phần và cập nhật biểu mẫu script. Sau đó, bạn chỉ cần thiết lập các thuộc tính, thêm mã vào các trình xử lý sự kiện và sử dụng các phương thức cần thiết để tạo một biểu mẫu script hoạt động.
Tạo thành phần trong script
Có thể tạo hoặc hủy trực tiếp các thành phần trong script bằng cách truyền tham số Nil cho Constructor của một thành phần. Thông thường, bạn không cần truyền handle của biểu mẫu vì biểu mẫu script sẽ tự động xử lý việc này. Ví dụ, bạn có thể tạo và hủy các hộp thoại Open và Save (các lớp TOpenDialog và TSaveDialog từ Embarcadero Delphi RTL).
Tùy chỉnh biểu mẫu script
Những điểm chính khi tùy chỉnh biểu mẫu script:
-
Để buộc một 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 một biểu mẫu, hãy đặt
FormKindthành một trong các giá trị sau:fkNone,fkNormal,fkServerPanelhoặcfkModal. -
Nếu
fkModalđược đóng, biểu mẫu sẽ là biểu mẫu dạng modal — tức là chờ thao tác của người dùng trước khi tiếp tục, chẳng hạn như đóng biểu mẫu. NếufkServerPanel, biểu mẫu sẽ được hiển thị dưới dạng bảng Server. NếufkNormal, biểu mẫu sẽ hoạt động như một biểu mẫu không modal thông thường. -
Để loại bỏ các thanh cuộn mặc định 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 thành khung MDI hoặc cửa sổ con MDI, 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ả sẽ 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 biểu mẫu;HeightvàWidthbiểu thị toàn bộ vùng của biểu mẫu). -
Để chỉ định điều khiển nào nhận tiêu điểm ban đầu trong biểu mẫu khi chạy, hãy sử dụng thuộc tính
ActiveControl. -
Để chuyển tất cả cá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 chứa nhiều menu, hãy sử dụng thuộc tính
Menu.
Làm mới biểu mẫu script và các thành phần
Khi bề mặt hiển thị của biểu mẫu script không còn được cập nhật, chẳng hạn như các điều khiển không được cập nhật hoặc vẽ lại, các điều khiển có thể trông như bị treo hoặc bị lỗi hiển thị — nguyên nhân có thể là do script đó đang xử lý nền với cường độ cao.
Phương thức Update của biểu mẫu script và nhiều thành phần script trong bảng Tool Palette cho phép làm mới nội dung đồ họa của biểu mẫu hoặc của các điều khiển cụ thể. Các dòng chứa phương thức Update được tô nền xám trong ví dụ bên dưới.
StatusBar component and its Update method Example:
Procedure TConverterForm.loadbuttonClick(Sender: TObject);
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
ShowWarning('The image is not a monochrome!');
Close;
End;
lImageSize.Caption := IntToStr(Image1.Picture.Width) + ' x ' +
IntToStr(Image1.Picture.Height) + ' mils';
convertbutton.Enabled := True;
LoadButton.Enabled := False;
XStatusBar1.SimpleText := ' Ready...';
XStatusBar1.Update;
End;
End;
Đoạn mã ở trên được trích từ dự án script PCB Logo Creator, có thể tìm thấy trong thư mục Scripts\Delphiscript Scripts\Pcb\PCB Logo Creator của bộ script có thể tải xuống.