Tổng quan & Thiết lập Hệ thống Scripting
Sơ lược
- Hiểu vai trò của các đơn vị mã tập lệnh, biểu mẫu tập lệnh và các bảng điều khiển dùng để viết và gỡ lỗi tập lệnh.
- Tìm hiểu cách mở và chạy tập lệnh mẫu, bao gồm dự án “Hello World”.
- Khám phá các thiết lập về hoạt động của trình soạn thảo, màu cú pháp, tùy chọn hiển thị, dự án tập lệnh toàn cục và thiết kế biểu mẫu.
Hệ thống tập lệnh của Altium Designer cung cấp đầy đủ các công cụ và tính năng cần thiết để tạo tập lệnh tự động hóa các tác vụ trong phần mềm.
Trình soạn thảo tập lệnh, trình gỡ lỗi và các bảng điều khiển tập lệnh phối hợp với nhau để giúp bạn viết và gỡ lỗi tập lệnh một cách dễ dàng. Bạn có thể chạy tập lệnh trực tiếp từ trình soạn thảo hoặc gán tập lệnh cho một mục menu, thanh công cụ hay phím tắt để áp dụng cho tài liệu hiện tại – chẳng hạn như bản bố trí PCB – bất cứ lúc nào.

Altium Designer hiển thị các cửa sổ Mã tập lệnh và Biểu mẫu cùng với các bảng Object Inspector, Code Explorer và Tool Palette .
Các tính năng của hệ thống tập lệnh
Hệ thống tập lệnh gồm hai phần chính – trình soạn thảo và trình gỡ lỗi. Các tính năng chính như sau:
-
Project access – Có thể lưu tập lệnh trong dự án tập lệnh hoặc dự án thiết kế. Các tập lệnh trong cùng một dự án có thể truy cập các thủ tục từ bất kỳ tập lệnh nào thuộc dự án đó.
-
Scripting Editor – Trình soạn thảo tập lệnh có trình soạn thảo văn bản chuyên dụng với nhiều tùy chọn để thiết lập môi trường soạn thảo và tô màu cú pháp.
-
Scripting Panels – Hệ thống tập lệnh có một số bảng điều khiển giúp bạn viết mã và gỡ lỗi tập lệnh nhanh chóng.
-
Scripting Debugger – Nếu tập lệnh gặp lỗi trong khi thực thi, một hộp thoại sẽ xuất hiện kèm thông báo lỗi ngắn gọn. Bạn có thể xem trước các biến trong cửa sổ Watches, theo dõi mã và điều khiển việc thực thi tập lệnh bằng Trình gỡ lỗi tập lệnh.
-
Scripting Languages – Có thể tạo tập lệnh bằng DelphiScript và VBScript nếu ngôn ngữ này được bật dưới dạng ngôn ngữ cũ.
Đơn vị mã và biểu mẫu tập lệnh
Dự án tập lệnh hỗ trợ hai loại tài liệu tập lệnh – Đơn vị mã tập lệnh và Biểu mẫu tập lệnh. Đơn vị mã tập lệnh cho phép bạn viết các thủ tục và hàm độc lập. Biểu mẫu tập lệnh cho phép bạn xây dựng các hộp thoại có điều khiển và trình xử lý sự kiện, cũng như các thủ tục và hàm.
- Đơn vị mã tập lệnh có thể sử dụng Giao diện lập trình ứng dụng (API) X2 để sửa đổi hoặc thao tác với các đối tượng thiết kế trên tài liệu thiết kế. Biểu mẫu tập lệnh chứa các điều khiển làm giao diện người dùng và tận dụng API X2 để cung cấp các hộp thoại tập lệnh thao tác trên tài liệu thiết kế đang hoạt động.
- Biểu mẫu tập lệnh là một đơn vị biểu mẫu trực quan được tập lệnh hỗ trợ. Khi hoạt động, biểu mẫu thể hiện dưới dạng một cửa sổ hộp thoại.
- Biểu mẫu tập lệnh có hai chế độ xem – Mã tập lệnh và Biểu mẫu tập lệnh. Chế độ xem Mã tập lệnh chứa các trình xử lý sự kiện và thủ tục/hàm. Chế độ xem Biểu mẫu tập lệnh thể hiện một biểu mẫu hộp thoại (thuộc các loại khác nhau), chứa các điều khiển cùng với trình xử lý sự kiện tương ứng.
-
Biểu mẫu tập lệnh có hai tệp liên quan. Một tệp
*.paschứa các trình xử lý sự kiện và thủ tục/hàm, còn một tệp*.dfmchứa thông tin chi tiết về chính biểu mẫu tập lệnh cùng với các thành phần và vị trí của chúng. - Thành phần là một đối tượng điều khiển trực quan hoặc phi trực quan (được đặt từ bảng Bảng công cụ), tiếp nhận thông tin đầu vào từ người dùng, chẳng hạn như thao tác nhấp chuột hoặc một chuỗi ký tự được nhập. Trong quá trình thiết kế, bạn có thể sử dụng bảng Trình kiểm tra đối tượng để thao tác với các thành phần trên Biểu mẫu tập lệnh. Các thành phần có thể được sử dụng trong bất kỳ Biểu mẫu tập lệnh nào, với bất kỳ bộ ngôn ngữ nào mà hệ thống tập lệnh hỗ trợ.
-
Một thành phần (đối tượng điều khiển) có các phương thức, thuộc tính và sự kiện mà Biểu mẫu tập lệnh có thể sử dụng.
- Phương thức là những hành động mà một đối tượng có thể thực hiện.
- Thuộc tính thể hiện dữ liệu chứa trong đối tượng mà bạn có thể truy cập hoặc sửa đổi.
- Sự kiện là những điều kiện mà một thành phần trên Biểu mẫu tập lệnh có thể phản hồi.
- Biểu mẫu tập lệnh có các trình xử lý sự kiện để xử lý những điều kiện được ghi nhận, chẳng hạn như khi nhấp vào một nút trên biểu mẫu.
Ví dụ về tập lệnh trong Altium Designer
Các tập lệnh ví dụ và tham chiếu là nguồn tài nguyên hữu ích để tìm hiểu cách áp dụng giao diện đối tượng, phương thức, quy trình, thuộc tính và thành phần trong tập lệnh. Bạn cũng có thể dùng chúng làm cơ sở cho các dự án tập lệnh của riêng mình.
Chạy một ví dụ
Để chạy nhanh một ví dụ tập lệnh trong Altium Designer, trước tiên hãy mở một dự án ví dụ hoặc một tệp tập lệnh riêng lẻ từ một trong các thư mục tập lệnh ví dụ – chẳng hạn như dự án 'Hello World' đơn giản (HelloWorld.PRJSCR) trong thư mục Scripts\Delphiscript Scripts\General.

Dự án DelphiScript Hello World được mở trong bảng Projects .
Dự án chứa hai phiên bản của tập lệnh 'Hello World', trong đó phiên bản thứ hai (HelloWorlDialog.pas) minh họa cách sử dụng cơ bản một đơn vị Biểu mẫu. Nhấp đúp vào tên tập lệnh để mở và kiểm tra tập lệnh trong trình soạn thảo – lưu ý rằng bạn có thể chạy tập lệnh mà không cần mở tập lệnh đó trong trình soạn thảo.
Để chạy một trong các tập lệnh, chọn File » Run Script từ các menu chính, sau đó chọn một thủ tục tập lệnh có sẵn trong hộp thoại Select Item To Run. Khi chạy một phiên bản, một hộp thoại sẽ mở ra để hiển thị thông báo.
Cách nhanh chóng và đơn giản để chạy một tập lệnh ví dụ.
Thiết lập hệ thống tập lệnh
Tùy chọn
Bạn có thể cấu hình các thiết lập tùy chọn mặc định cho hệ thống tập lệnh trong hộp thoại Tùy chọn, được truy cập bằng cách nhấp vào nút điều khiển
ở góc trên bên phải của không gian thiết kế.
Tùy chọn chung
Trang Trình soạn thảo văn bản – Chung của hộp thoại Preferences cho phép bạn thiết lập các yêu cầu soạn thảo tập lệnh, chẳng hạn như cách tìm kiếm chuỗi, cách đặt tab và thụt lề dòng, cách gán phím cùng một số tùy chọn nâng cao khác.

Trang Text Editors – General của hộp thoại Preferences
Tùy chọn màu sắc
Trang Trình soạn thảo văn bản – Màu sắc của hộp thoại Preferences cho phép bạn cấu hình màu cú pháp trong Trình soạn thảo tập lệnh cho ngôn ngữ lập trình tập lệnh mà bạn chọn, đồng thời thiết lập màu cho các thành phần trong trình soạn thảo. Ví dụ: màu đen cho nền, màu trắng cho các từ khóa chú thích, v.v.

Trang Text Editors – Colors của hộp thoại Preferences
Tùy chọn hiển thị
Trang Trình soạn thảo văn bản – Hiển thị của hộp thoại Preferences cho phép bạn cấu hình các đặc điểm hiển thị của tập lệnh, chẳng hạn như hiển thị lề phải và số dòng, tô sáng cú pháp và thu gọn/mở rộng các khối mã.

Trang Text Editors – Display của hộp thoại Preferences
Tùy chọn dự án toàn cục
Trang Hệ thống lập trình tập lệnh – Dự án toàn cục của hộp thoại Preferences liệt kê các dự án tập lệnh hiện có (đã cài đặt). Bạn có thể cài đặt, gỡ bỏ hoặc sắp xếp lại thứ tự các dự án tập lệnh.

Trang Scripting System – Global Projects của hộp thoại Preferences
Tùy chọn trình thiết kế biểu mẫu
Trang Hệ thống lập trình tập lệnh – Trình thiết kế biểu mẫu của hộp thoại Preferences cung cấp các tùy chọn về lưới và ký hiệu định danh thành phần cho tài liệu biểu mẫu tập lệnh.

Trang Scripting System – Form Designer của hộp thoại Preferences