Sử dụng các thành phần biểu mẫu VBScript

Sơ lược

Tìm hiểu cách xây dựng các biểu mẫu VBScript tương tác trong Altium Designer bằng các bảng Tool Palette và Object Inspector. Bài viết này giải thích về các thành phần trực quan và phi trực quan, cách các thuộc tính, sự kiện và phương thức định hình hành vi của chúng, cũng như cách hiển thị biểu mẫu và phản hồi thao tác nhập của người dùng. Hãy đọc tiếp để áp dụng những kiến thức cơ bản này vào biểu mẫu trong tập lệnh của bạn.

- Tạo biểu mẫu cho tập lệnh, đặt các thành phần và cấu hình thuộc tính của chúng.
- Hiển thị hộp thoại dạng modal bằng ShowModal và xử lý phản hồi OK và Cancel.
- Viết trình xử lý sự kiện để phản hồi thao tác nhấp nút và kiểm tra trường nhập văn bản bị bỏ trống.
Tìm hiểu sâu hơn với AI:

Sử dụng thành phần trong biểu mẫu VBScript

Mặc dù biểu mẫu và thành phần dựa trên Thư viện thành phần trực quan (VCL) của Embarcadero Delphi™, Tool Palette dựa trên Delphi của Altium Designer vẫn được dùng để thả các điều khiển lên biểu mẫu khi sử dụng VBScript. Ngoài ra, các trình xử lý sự kiện được tạo và mã được viết bằng ngôn ngữ VBScript, bất kể nguồn gốc Delphi của biểu mẫu/thành phần trong Altium Designer.

Tổng quan về thành phần

Hệ thống viết kịch bản xử lý hai loại thành phần: trực quan và 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 nhiều tác vụ khác nhau, chẳng hạn như các chức năng do thành phần Timer, OpenDialog và MainMenu cung cấp. Ví dụ, thành phần phi trực quan Timer được dùng để kích hoạt mã cụ thể theo các khoảng thời gian định sẵn và không bao giờ hiển thị với người dùng. Các thành phần Button, Edit và Memo là thành phần trực quan — người dùng có thể nhìn thấy chúng.

Cả hai loại thành phần đều xuất hiện khi thiết kế, nhưng các thành phần phi trực quan 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 tính của đối tượng, ảnh hưởng đến cách 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ị trong biểu mẫu kịch bản hay không.

event là một hành động hoặc sự việc được kịch bản phát hiện. Trong kịch bản, lập trình viên viết mã cho từng trình xử lý sự kiện, được thiết kế để nắm bắt một sự kiện cụ thể, chẳng hạn như 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ả biểu mẫu kịch bản đề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, ô Edit cho phép người dùng nhập dữ liệu, còn Button có thể được dùng để khởi tạo 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, cho phép người dùng tương tác với chúng khi kịch bản đang chạy (thời gian chạy). Nhiệm vụ của lập trình viên kịch bản là quyết định điều gì 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 ô Edit.

Hệ thống viết kịch bản cung cấp nhiều thành phần để tạo giao diện người dùng đơn giản hoặc phức tạp cho kịch bản. Tất cả các thành phần có thể đặt lên biểu mẫu đều nằm trong bảng Tool Palette.

Để đặ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 đó trong bảng Tool Palette rồi nhấp đúp vào biểu tượng. Thao tác này đặt thành phần lên biểu mẫu đang hoạt động tại vị trí mặc định, với chiều rộng và chiều cao mặc định. Hình thức hiển thị của hầu hết các thành phần được xác định bởi tập hợp thuộc tính tương ứng.

Sau khi được đặt với vị trí và kích thước mặc định, thành phần có thể được thay đổi kích thước hoặc vị trí bằng chuột hoặc thông qua bảng Object Inspector. Khi một thành phần được thả lên biểu mẫu, hệ thống viết kịch bản tự động tạo mã cơ bản cần thiết để sử dụng thành phần đó và cập nhật biểu mẫu kịch bản. Để thành phần trên biểu mẫu hoạt động, việc còn lại là 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 khi cần.

Thiết kế biểu mẫu kịch bản

Biểu mẫu kịch bản được thiết kế để tương tác với người dùng trong môi trường Altium Designer. Thiết kế biểu mẫu kịch bản là phần cốt lõi của quá trình phát triển trực quan trong Altium Designer.

Mỗi thành phần được đặt lên biểu mẫu kịch bản 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) và có mối liên hệ với mã kịch bản tương ứng (tệp *.vbs). Vì vậy, với mỗi biểu mẫu kịch bản, luôn có tệp *.vbs và tệp *.dfm tương ứng.

Khi làm việc với biểu mẫu kịch bản và các thành phần của nó, bạn có thể truy cập và sửa đổi các thuộc tính bằng bảng Object Inspector. 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 khung chọn bao quanh các thành phần trên biểu mẫu kịch bản. Biểu mẫu kịch bản có tiêu đề được ánh xạ tới thuộc tính Caption trong bảng Object Inspector.

Tạo biểu mẫu kịch bản mới

Khi một dự án kịch bản đang mở, hãy nhấp chuột phải vào dự án trong bảng Projects, rồi lần lượt chọn mục Add New to Project và VB Script Form từ các menu ngữ cảnh. Một biểu mẫu kịch bản mới được tạo với tên mặc định EditScript1.vbs . Ngoài ra, trong dự án *.PrjPCB, hãy chọn lệnh File » New » Script Files » VB Script Form.

Hiển thị biểu mẫu kịch bản

Kịch bản cần có một thủ tục để hiển thị biểu mẫu khi biểu mẫu kịch bản được thực thi trong Altium Designer. Trong thủ tục này, phương thức ShowModal được gọi cho biểu mẫu. Thuộc tính Visible của biểu mẫu cần được đặt thành false (bỏ chọn) để phương thức ShowModal của biểu mẫu kịch bản hoạt động chính xác.

Ví dụ về ShowModal

Sub RunDialog
  DialogForm.ShowModal
End Sub

Ví dụ ShowModal ở trên là một cách đơn giản để hiển thị biểu mẫu kịch bản khi hộp thoại RunDialog từ kịch bản đượ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ụ ModalResult bên dưới phức tạp hơn. Các phương thức ở phần sau của ví dụ được dùng cho các nút trong biểu mẫu kịch bản. Các phương thức của kịch bản khiến hộp thoại đóng khi người dùng nhấp vào nút OK hoặc Cancel, và phương thức ShowModal sẽ trả về giá trị tương ứng là mrOk hoặc mrCancel.

ModalResult Example

sub bOKButtonClick(Sender)
  ModalResult := mrOK
end sub
 
sub bCancelButtonClick(Sender)
  ModalResult := mrCancel
end sub
 
sub RunShowModalExample
  'Form Visible property must be false for ShowModal to work properly.
  If Form.ShowModal = mrOk     Then ShowMessage("mrOk")
  If Form.ShowModal = mrCancel Then ShowMessage("mrCancel")
end sub

Có thể đạt được kết quả tương tự như trên bằng cách đặt giá trị ModalResult thành mrOk cho nút OK và thành mrCancel cho nút Cancel trong các trình xử lý sự kiện tương ứng. Khi người dùng nhấp vào một trong hai nút, 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 kịch bản sẽ tự động đóng biểu mẫu kịch bản.

Lưu ý rằng để đặt ModalResult của biểu mẫu thành hủy khi người dùng nhấn phím Esc, hãy đặt thuộc tính Cancel của nút Cancel thành true (được chọn) trong bảng Object Inspector, 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 người dùng nhập

Một trong những thành phần phổ biến có thể tiếp nhận dữ liệu người dùng nhập là thành phần EditBox. Thành phần EditBox này có một trường văn bản để người dùng nhập chuỗi ký tự. Ngoài ra còn có các thành phần khác có thể tiếp nhận văn bản, chẳng hạn như thành phần chỉnh sửa có mặt nạ, tức là thành phần chỉnh sửa có mặt nạ nhập liệu cho trường văn bản. Mặt nạ này kiểm soát hoặc lọc dữ liệu đầu vào và được lưu trong một chuỗi tham số.

Ví dụ bên dưới minh họa điều gì xảy ra khi người dùng nhấp vào nút sau khi nhập văn bản vào ô chỉnh sửa. Lưu ý rằng nếu người dùng không nhập văn bản nào vào thành phần chỉnh sửa, trình xử lý sự kiện sẽ phản hồi bằng một thông báo cảnh báo.

sub TScriptForm.ButtonClick(Sender)
  If Edit1.Text = "" Then
  ShowMessage("Warning - empty input!")
  Exit
  End
  ' do something else for the input
End sub

Lưu ý rằng người dùng có thể chuyển tiêu điểm nhập liệu trên biểu mẫu 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 chọn một biểu mẫu hoặc thành phần, Altium Designer gửi một thông điệp đến Hệ thống tạo tập lệnh. Hệ thống này phản hồi thông báo sự kiện bằng cách gọi phương thức xử lý sự kiện thích hợp.

Viết trình xử lý sự kiện

Một tập lệnh có thể cần phản hồi các sự kiện xảy ra với một thành phần trong thời gian chạy. 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 một nút, và một đoạn mã phản hồi hành động đó. Đoạn mã phản hồi này là trình xử lý sự kiện, có chức năng sửa đổi các giá trị thuộc tính và gọi các phương thức.

Ngoài các thuộc tính, mỗi thành phần còn có một tập hợp tên sự kiện. Người lập trình tập lệnh quyết định cách tập lệnh phản ứng vớ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 điệp đến tập lệnh và tập lệnh phản ứng với sự kiện mới này — nếu sự kiện OnClick của nút được chỉ định, trình xử lý sự kiện đó sẽ được thực thi.

Tất cả các thành phần như vậy cũng có sự kiện nhận và mất tiêu điểm. Tuy nhiên, nếu không 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), tập lệnh sẽ bỏ qua sự kiện.

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à kích hoạt thẻ 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à kích hoạt thẻ Events trong bảng Object Inspector. Để tạo một thủ tục xử lý sự kiện cho thành phần, hãy chọn sự kiện thích hợp rồi nhấp đúp vào tên sự kiện đó.

Ví dụ: chọn thành phần Button1 từ bảng Tool Palette, thả thành phần đó lên biểu mẫu tập lệnh rồi nhấp đúp vào bên cạnh tên sự kiện OnClick. Hệ thống tạo tập lệnh sẽ chuyển tiêu điểm về Trình soạn thảo mã, nơi mã khung cho sự kiện OnClick đã được tạo. 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 nhấp chuột và mã bên trong trình xử lý sự kiện sẽ được thực thi. Cụ thể, phương thức Close sẽ đóng biểu mẫu tập lệnh.

Tóm lại, để tạo trình xử lý sự kiện trong tập lệnh, hãy chọn một thành phần trên biểu mẫu hoặc thông qua bảng Object Inspector, rồi nhấp đúp vào bên phải sự kiện mong muốn (chẳng hạn OnClick) trong thẻ Events của Inspector — khung mã thích hợp sẽ xuất hiện trong tập lệnh.

Ngoài ra, khi bạn nhấp đúp vào một nút, hệ thống tạo tập lệnh sẽ thêm trình xử lý cho sự kiện OnClick. Các loại thành phần khác sẽ có những hành động mặc định hoàn toàn khác.

Phương thức của thành phần

Xem Tài liệu tham khảo về thành phần để biết danh sách các phương thức của một thành phần và tham khảo tài liệu Embarcadero Delphi để biết thông tin chi tiết hơn.

Tạo thành phần trong thời gian chạy

Có thể tạo và hủy các thành phần trực tiếp trong tập lệnh. Thông thường, không cần truyền handle của biểu mẫu vì biểu mẫu tập lệnh tự động xử lý việc này — thay vào đó, hãy truyền tham số Nil vào hàm khởi tạo của thành phần.

Ví dụ: có thể tạo và hủy các hộp thoại Open và Save (các lớp TOpenDialog và TSaveDialog, thuộc Delphi RTL).

AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Nav
Contents
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Tài liệu cũ

Tài liệu Altium Designer không còn được phân phiên bản. Nếu bạn cần truy cập tài liệu cho các phiên bản cũ hơn của Altium Designer, hãy truy cập mục Tài liệu cũ trên trang Trình cài đặt khác.

Contents