Viết Script
Sơ lược
- Tìm hiểu các khái niệm cốt lõi về lập trình tập lệnh, bao gồm quy trình, thành phần, giao diện đối tượng, thuộc tính, phương thức và sự kiện.
- Khám phá cách tạo và chạy một thủ tục DelphiScript cơ bản, cũng như thiết lập thủ tục khởi động cho dự án.
- Tìm hiểu cách tạo biểu mẫu tập lệnh, thêm nút, cấu hình thuộc tính của thành phần và trình xử lý sự kiện.
Viết tập lệnh
Có một số khái niệm và thuật ngữ thiết yếu được áp dụng khi viết tập lệnh:
- Quy trình là các chuỗi lệnh mà bạn có thể sử dụng để thực thi lệnh trong tập lệnh.
- Thành phần là các đối tượng điều khiển trực quan trên bảng Tool Palette mà bạn có thể kéo và thả vào biểu mẫu tập lệnh để thao tác với thiết kế.
- Một thành phần được đặt trên biểu mẫu tập lệnh có các phương thức, thuộc tính và sự kiện.
- Giao diện đối tượng là các giao diện đối tượng đặc biệt mà bạn có thể sử dụng để trích xuất và sửa đổi dữ liệu trên tài liệu thiết kế từ tập lệnh của mình.
Ngôn ngữ tập lệnh
Ngôn ngữ tập lệnh mặc định được đặt là DelphiScript (*.pas). Bản thân bộ máy thực thi tập lệnh được viết bằng Embarcadero Delphi, còn bảng Tool Palette dựa trên VCL (Thư viện thành phần trực quan) của Delphi.
Một đơn vị mã DelphiScript
Bạn có thể thực hiện nhanh một bài tập viết tập lệnh cơ bản bằng cách trước tiên tạo một dự án và tệp tập lệnh mới. Giả sử dự án và tệp tập lệnh được đặt sử dụng ngôn ngữ DelphiScript, bạn có thể nhập một tập lệnh 'Hello World' đơn giản như bên dưới.
Procedure ShowAMessage;
Var
DefaultMessage;
Begin
DefaultMessage := 'Hello World!';
ShowMessage(DefaultMessage);
End;
Trong thủ tục có một hàm ShowMessage tiêu chuẩn của DelphiScript để mở hộp thoại với thông báo "Hello World", được xác định bởi biến DefaultMessage.
Chạy tập lệnh
Để chạy một trong các tập lệnh, hãy 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 từ 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.

Chạy một đơn vị mã tập lệnh HelloWorld đơn giản từ menu File » Run Script.
Bạn cũng có thể thực thi tập lệnh bằng lệnh Run của trình soạn thảo, thông qua nút Run , phím tắt F9 hoặc bằng cách chọn Run » Run từ các menu chính.
Ngoài bản thân lệnh Run, menu thả xuống Run còn cung cấp nhiều lệnh điều khiển và gỡ lỗi tập lệnh.
Khi lệnh Run được chọn lần đầu tiên, hộp thoại Select Item to Run sẽ mở ra, cho phép bạn chỉ định thủ tục chính của tập lệnh (ShowAMessage trong trường hợp này). Sau khi thiết lập, bạn có thể dễ dàng chạy lại tập lệnh nhiều lần từ trình soạn thảo bằng lệnh Run . Sử dụng Run » Set Project Startup Procedure để chuyển thiết lập sang một thủ tục khác, hoặc đóng rồi mở lại dự án tập lệnh để xóa thiết lập.
Để dừng một tập lệnh đang chạy, hãy sử dụng nút Stop , chọn Run » Stop từ menu chính hoặc sử dụng phím tắt Ctrl+F3.
Một biểu mẫu DelphiScript
Phát triển thêm từ dự án HelloWorld đã tạo ở trên, bạn có thể tạo một tập lệnh tương tự bằng cách sử dụng một đơn vị biểu mẫu.
Biểu mẫu tập lệnh là một cửa sổ hộp thoại có thể chứa nhiều điều khiển như nút, ô văn bản nhiều dòng và hộp danh sách. Biểu mẫu có các trình xử lý sự kiện phản hồi khi một điều khiển phát sinh sự kiện, chẳng hạn như khi nhấp vào nút.
Để tạo biểu mẫu tập lệnh mới, hãy nhấp chuột phải vào tên dự án trong bảng Projects, chọn tùy chọn Add New to Project rồi chọn Script Form. Bạn có thể lưu và đổi tên tập lệnh bằng File » Save As từ các menu chính.
Sau khi tạo một dự án tập lệnh mới, hãy thêm một tập lệnh mới vào dự án.
Để xem và chỉnh sửa các giá trị thuộc tính của biểu mẫu đang được chọn hoặc các thành phần của biểu mẫu đó, hãy mở bảng Object Inspector. Bảng Object Inspector được dùng để thay đổi các thuộc tính của biểu mẫu và chèn mã vào các trình xử lý sự kiện liên kết với biểu mẫu hiện tại.

Cấu hình cửa sổ và các thuộc tính của biểu mẫu tập lệnh được minh họa trong bảng Object Inspector.
Lưu ý rằng biểu mẫu tập lệnh có hai thẻ ở cuối tài liệu: thẻ Code và Form .
Thẻ Code chứa các trình xử lý sự kiện và thủ tục như minh họa ở trên, trong khi thẻ Form biểu diễn hộp thoại và chứa các điều khiển cùng các trình xử lý sự kiện liên quan. Sử dụng các thẻ hoặc phím tắt F12 để chuyển đổi giữa hai chế độ này.
Bảng Object Inspector cho phép bạn xem và chỉnh sửa các thuộc tính cũng như sự kiện của các thành phần trong biểu mẫu tập lệnh đang hoạt động. Nhấp vào một thành phần trên biểu mẫu tập lệnh đang hoạt động trong cửa sổ trình chỉnh sửa thiết kế sẽ chọn thành phần đó và hiển thị các thuộc tính liên quan trong bảng Object Inspector. Ngoài ra, bạn có thể sử dụng trường thả xuống ở đầu bảng để chọn từ danh sách tất cả các thành phần hiện được đặt trên biểu mẫu đang hoạt động. Bản thân biểu mẫu cũng có trong danh sách này.

Sử dụng bảng Object Inspector để cấu hình hộp thoại biểu mẫu và hành động của nó.
Thông tin được hiển thị trên hai thẻ – Properties và Events:
- Thẻ Properties của bảng liệt kê tất cả các thuộc tính của thành phần được chọn. Danh sách thuộc tính có sẵn cụ thể sẽ phụ thuộc vào loại thành phần đang được xem xét. Thuộc tính 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 (trong Behavior danh mục con) xác định đối tượng có được hiển thị trên biểu mẫu script nơi nó được đặt hay không. Có thể sửa đổi các thuộc tính của thành phần theo yêu cầu. Nhấp vào trường bên phải thuộc tính rồi nhập trực tiếp, bật/tắt hộp kiểm hoặc chọn một mục từ danh sách thả xuống, tùy trường hợp.
- Tab Events của bảng cung cấp danh sách tất cả các sự kiện mà thành phần đang được chọn có thể phản hồi. Tương tự, danh sách sự kiện cụ thể sẽ phụ thuộc vào loại thành phần đang được xem xét. Khi một sự kiện xảy ra, chẳng hạn như khi nhấp vào một nút trên biểu mẫu, script sẽ thực hiện hành động phù hợp, với điều kiện thủ tục xử lý sự kiện đó đã được định nghĩa trong mã. Loại thủ tục này được gọi là trình xử lý sự kiện.
Có thể thêm bộ khung cho trình xử lý sự kiện vào mã của tài liệu script từ bảng Object Inspector. Chỉ cần chọn thành phần mà bạn muốn định nghĩa sự kiện, chọn loại sự kiện cụ thể rồi nhấp đúp vào trường bên phải sự kiện. Một tên sẽ được tạo cho sự kiện và được dùng để đặt tên cho thủ tục xử lý sự kiện - FormName.EventName. Mã khung của thủ tục xử lý sự kiện sau đó được thêm vào mã script chính, đồng thời tab chứa mã này được kích hoạt trong không gian thiết kế. Tiếp theo, bạn có thể viết phần nội dung của thủ tục xử lý sự kiện để tạo ra phản hồi mong muốn khi sự kiện xảy ra và được script đang chạy phát hiện.
Phần dưới cùng của bảng cung cấp mô tả tóm tắt về thuộc tính hoặc sự kiện đang được chọn, nếu có.
Đối với script biểu mẫu này, hãy thay đổi các thuộc tính Caption của biểu mẫu trong bảng Object Inspector từ HelloWorldForm thành Hello World!. Các chuỗi này khớp với các chuỗi được dùng trong mã ví dụ về trình xử lý sự kiện và thủ tục ở bên dưới.
Thêm và cấu hình các điều khiển
Sau khi cấu hình biểu mẫu cơ bản, bạn có thể thêm các điều khiển vào hộp thoại theo yêu cầu bằng cách truy cập bảng Tool Palette. Tool Palette, dựa trên thư viện Visual Component Library của Delphi, là một bảng thành phần cung cấp nhiều điều khiển cửa sổ, được sắp xếp theo các danh mục thành phần (xem các trang Thành phần đồ họa cho script và Danh mục thành phần để biết thêm chi tiết).

Có thể mở rộng và thu gọn các phần trong bảng Tool Palette bằng các tab tiêu đề vùng.
Sử dụng các điều khiển ở đầu bảng, tên danh mục và menu chuột phải để cấu hình cách hiển thị các điều khiển trong bảng: mở rộng/thu gọn danh mục, thay đổi cách hiển thị các mục trong bảng thành phần, v.v.
Đối với phiên bản hộp thoại của dự án 'Hello World', có hai nút trên biểu mẫu - Display và Close. Nhấp vào TButton trong vùng Standard của bảng Tool Palette.
Thực hiện thao tác này hai lần để đặt hai nút lên biểu mẫu. Một nút sẽ được dùng để hiển thị thông báo 'Hello World!' trong một hộp thoại riêng, còn nút thứ hai sẽ được dùng để đóng hộp thoại chính.
Tất cả các thành phần trong bảng đều có các thuộc tính, phương thức và sự kiện tương ứng, trong đó:
-
Một Property là đặ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 đối tượng có hiển thị trên biểu mẫu script hay không. - Một Method là 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 đó.
- Một Event là 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 để bắt một sự kiện cụ thể, chẳng hạn như thao tác nhấp chuột.
Có thể xem và sửa đổi các thuộc tính cũng như sự kiện của thành phần sau khi đặt bằng bảng Object Inspector.
Sử dụng bảng Object Inspector, bạn có thể thay đổi tên và chú thích mặc định của hai nút.
Đặt tên nút thứ nhất thành bDisplay và chú thích của nút thành Display. Đặt tên nút thứ hai thành bClose và chú thích của nút thành Close. Việc này nhằm khớp với mã ví dụ về trình xử lý sự kiện được trình bày bên dưới.

Chọn một thành phần và chỉnh sửa các thuộc tính của nó trong bảng Object Inspector.
Có thể xây dựng mã trình xử lý sự kiện bằng cách tham chiếu trực tiếp đến các điều khiển trên biểu mẫu. Trong ví dụ này, nút Display sẽ mở hộp thoại ShowMessage phía trên biểu mẫu hiện có, còn thao tác nhấn nút Close sẽ đóng biểu mẫu này.
Mã trình xử lý sự kiện
Nhấp đúp vào nút Display sẽ mở biểu mẫu ở chế độ xem mã và tạo mã khung cho trình xử lý sự kiện của nút. Ngoài ra, bạn có thể chọn nút rồi chọn tab Events trong bảng Object Inspector. Nhấp đúp vào sự kiện OnClick trong bảng sẽ mở chế độ xem mã như trên. Trong chế độ xem mã, có thể thêm câu lệnh ShowMessage vào trình xử lý sự kiện như trong đoạn mã bên dưới.
Procedure THelloWorldForm.bDisplayClick(Sender: TObject);
Begin
ShowMessage('Hello World!');
End;
OnClick sử dụng câu lệnh Close (form):
Procedure THelloWorldForm.bCloseClick(Sender: TObject);
Begin
Close;
End;
Sau khi định nghĩa các trình xử lý sự kiện, cần có một thủ tục trong script làm điểm bắt đầu khi gọi hộp thoại từ phần mềm. Thủ tục này được thêm vào cuối mã script.
Lưu ý rằng tên biểu mẫu là HelloWorldForm và tên thủ tục là RunHelloWorld — cần đặt tên riêng biệt cho các biểu mẫu trong cùng một script để tránh trùng tên.
Procedure RunHelloWorld;
Begin
HelloWorldForm.ShowModal;
End;
Bạn có thể lưu script rồi chạy từ các menu chính (File» Run Script) bằng cách chạy mục thủ tục RunHelloWorld bên dưới mục HelloWorldDialog.
Ngoài ra, có thể gán thủ tục cho lệnh/nút Run thông qua menu Run » Set Startup Project Procedure.

Chạy tập lệnh biểu mẫu HelloWorld, trong đó nút Display trên biểu mẫu kích hoạt hộp thoại ShowMessage.
Bảng Object Inspector giúp dễ dàng thay đổi các thuộc tính và sự kiện của một đơn vị biểu mẫu. Ví dụ: để thay đổi vị trí của biểu mẫu trong không gian làm việc, hãy dùng bảng này để thay đổi giá trị poScreenCenter cho thuộc tính vị trí của biểu mẫu. Khi chạy tập lệnh, hộp thoại sẽ được đặt ở giữa màn hình.
Gọi thủ tục
Như đã đề cập ở trên, mọi tập lệnh (sử dụng cùng ngôn ngữ) trong một dự án đều có quyền truy cập các biến và thủ tục toàn cục, vì vậy một thủ tục trong tập lệnh này có thể gọi một thủ tục khác trong tập lệnh khác của dự án.
Có thể minh họa điều này bằng đoạn mã ShowAParametricMessage bổ sung trong dự án ví dụ HelloWorld:
Procedure ShowAParametricMessage(S : String);
Var
DefaultMessage;
Begin
DefaultMessage := 'Hello World!';
If S = '' Then ShowMessage(DefaultMessage)
Else ShowMessage(S);
End;
Đoạn mã này tạo một biến chuỗi 'S' có thể được truyền cho thủ tục ShowAParametricMessage.
Chuỗi được truyền vào sẽ được hiển thị bằng hàm hộp thoại ShowMessage, trong khi cấu trúc If-Then-Else đơn giản sẽ hiển thị thông báo mặc định 'Hello World!' nếu chuỗi rỗng.
Để xem cách hoạt động, hãy mở dự án ví dụ (HelloWorld.PrjScr) và thêm dòng được tô xám vào tập lệnh HelloWorldDialog (không phải tập lệnh HelloWorld), như minh họa bên dưới.
...
Procedure THelloWorldForm.bDisplayClick(Sender: TObject);
Begin
Showmessage('Hello World!');
End;
Procedure THelloWorldForm.bCloseClick(Sender: TObject);
Begin
ShowAParametricMessage('Goodbye World');
close;
End;
Procedure RunHelloWorld;
Begin
HelloWorldForm.ShowModal;
End;
...
Khi chạy tập lệnh HelloWorldDialog và nhấp vào nút Close , thủ tục toàn cục ShowAParametricMessage sẽ được gọi từ tập lệnh HelloWorld.

Một thủ tục có tham số trong tập lệnh HelloWorld được gọi từ tập lệnh HelloWorldDialog.
Lệnh gọi truyền chuỗi thông báo 'Goodbye World' cho thủ tục ShowAParametricMessage, vì vậy thông báo này sẽ hiển thị khi nhấp vào nút Close, trước khi biểu mẫu đóng.

Lệnh gọi trong tập lệnh ở trên chèn một thông báo được chỉ định vào thủ tục đóng biểu mẫu HelloWoldDialog.
Nếu tham số chuỗi được truyền vào là rỗng, ShowAParametricMessage(''), thông báo mặc định 'Hello World!' sẽ hiển thị theo định nghĩa trong thủ tục ShowAParametricMessage.
Duyệt các định danh trong tập lệnh bằng bảng Code Explorer
Bảng Code Explorer cung cấp bản tóm tắt trực quan về tất cả các định danh (biến, hàm và thủ tục) được sử dụng trong tài liệu tập lệnh đang hoạt động.

Bảng Code Explorer
Thông tin định danh xuất hiện trong bảng được nhóm vào các thư mục cấp cao nhất sau:
-
Procedures & Functions – bao gồm tất cả các thủ tục và hàm được khai báo trong tài liệu tập lệnh đang hoạt động. Với mỗi thủ tục/hàm, mọi tham số được truyền cho thủ tục/hàm hoặc các biến cục bộ của thủ tục/hàm đó cũng được liệt kê.
-
Variables – bao gồm tất cả các biến toàn cục được khai báo trong tài liệu tập lệnh đang hoạt động.
Nếu các biến cục bộ được khai báo cho một thủ tục/hàm, chúng sẽ được liệt kê trong thư mục con chứa biến, bên dưới thủ tục/hàm đó. Các biểu tượng riêng được dùng để phân biệt các loại định danh:
|
Thủ tục |
|
Hàm |
|
Tham số của thủ tục/hàm |
|
Biến (cục bộ hoặc toàn cục) |
Nhấp đúp vào một mục trong bảng (hoặc chọn mục đó rồi nhấn phím Enter) sẽ chuyển đến vùng mã tương ứng trong không gian thiết kế.


