Những điểm khác biệt giữa DelphiScript và Delphi

Sơ lược

DelphiScript có cú pháp quen thuộc tương tự Delphi, nhưng cách xử lý biến, chương trình con, tập hợp và lớp lại có những khác biệt quan trọng khi viết tập lệnh cho Altium Designer. Bài viết này giải thích những khác biệt đó, chỉ ra các tính năng ngôn ngữ không được hỗ trợ và hướng dẫn cách sử dụng các lớp có sẵn cùng các giao diện API của Altium Designer trong tập lệnh. Hãy đọc tiếp để hiểu rõ hơn những gì DelphiScript hỗ trợ và tự tin điều chỉnh tập lệnh của bạn.

- Hiểu về các biến dựa trên kiểu Variant, việc chuyển đổi kiểu tại thời điểm chạy và tác động của chúng đến hoạt động kiểm thử cũng như hiệu năng.
- Tìm hiểu những tính năng của Delphi không được hỗ trợ hoặc có cách hoạt động khác, bao gồm mảng, toán tử tập hợp, chương trình con lồng nhau và xử lý ngoại lệ.
- Xem cách sử dụng các lớp có sẵn và giao diện đối tượng của Altium Designer, bao gồm một ví dụ tạo lỗ via trên PCB.
Tìm hiểu sâu hơn với AI:

Khác biệt giữa DelphiScript và Delphi

Phần này trình bày những khác biệt cơ bản giữa ngôn ngữ viết script DelphiScript và ngôn ngữ lập trình Delphi của Embarcadero, cũng như ảnh hưởng của những khác biệt này khi sử dụng API Altium Designer.

Hệ thống viết script của Altium Designer sử dụng ngôn ngữ DelphiScript không định kiểu, vì vậy không có kiểu dữ liệu trong script. Mặc dù bạn có thể khai báo biến và kiểu của chúng, đồng thời chỉ định kiểu cho hàm/thủ tục hoặc tham số phương thức để mã dễ đọc hơn, DelphiScript sẽ chuyển đổi các biến chưa được khai báo khi script được thực thi. Vì vậy, chẳng hạn, bạn không thể định nghĩa bản ghi hoặc lớp.

Biến trong DelphiScript

Tất cả các biến trong script đều thuộc kiểu Variant; kiểu trong khai báo biến sẽ bị bỏ qua và có thể lược bỏ. Vì vậy, cả ba khai báo sau đều hợp lệ:

Var
a : Integer;
 
Var
b : Integer;
 
Var
  c, d;

Kiểu của tham số trong khai báo thủ tục/hàm cũng bị bỏ qua và có thể lược bỏ. Ví dụ, đoạn mã sau là hợp lệ:

Function Sum(a, b) : Integer;
Begin
  Result := a + b;
End;

Nhìn chung, biến Variant có thể được dùng để lưu trữ mọi kiểu dữ liệu và thực hiện nhiều phép toán cũng như chuyển đổi kiểu. Biến Variant được kiểm tra kiểu và tính toán tại thời điểm chạy. Trình biên dịch sẽ không cảnh báo về các lỗi có thể có trong mã; những lỗi này chỉ có thể được phát hiện thông qua kiểm thử kỹ lưỡng. Nhìn chung, những phần mã sử dụng biến Variant có thể được xem là mã thông dịch, vì nhiều phép toán không thể được xác định cho đến thời điểm chạy. Điều này có thể ảnh hưởng đến tốc độ thực thi mã.

Do đó, sau khi một biến Variant được khai báo và được gán một giá trị Variant, giá trị của biến có thể được sao chép sang bất kỳ kiểu dữ liệu tương thích hoặc không tương thích nào:

Var
V;
Begin
  // variable V can be assigned values of several different types:
  V := 10;
  V := 'Hello, World';
  V := 45.55;
End;

Nếu một biến được gán dữ liệu có kiểu không tương thích, trình thông dịch DelphiScript sẽ thực hiện chuyển đổi nếu có thể. Nếu không, lỗi thời gian chạy sẽ xuất hiện. Trên thực tế, biến Variant lưu thông tin kiểu cùng với dữ liệu, vì vậy DelphiScript chậm hơn mã Embarcadero Delphi tương đương đã được biên dịch.

Tập hợp trong script

DelphiScript không có kiểu tập hợp (Set) và không hỗ trợ các toán tử tập hợp, khác với ngôn ngữ Delphi vốn có kiểu tập hợp và hỗ trợ các toán tử tập hợp.

Để sử dụng tập hợp trong script DelphiScript, hãy dùng các hàm tích hợp sẵn để thao tác với tập hợp trong script.

Xem mục Sử dụng tập hợp trong DelphiScript để biết thêm thông tin

Hàm hoặc thủ tục nội bộ

Khi cân nhắc sử dụng hàm và thủ tục inside một hàm hoặc thủ tục, cách tiếp cận được khuyến nghị là viết các hàm/thủ tục độc lập — mặc dù vẫn cho phép sử dụng thủ tục/hàm đệ quy.

Không nên sử dụng đoạn mã hàm sau:

Function A
Function B
Begin
// blah
End;
Begin
B;
End;

Cấu trúc hàm được khuyến nghị:

Function B
Begin
// blah
End;

Function A
Begin
B;
End;

Từ khóa Result

Sử dụng từ khóa Result để đặt giá trị trả về trong một khối hàm. Ví dụ:

Function Foo : String;
Begin
Result := 'Foo Foo';
End;

Chương trình con lồng nhau

Các chương trình con lồng nhau được hỗ trợ, nhưng không thể sử dụng biến của hàm ngoài cùng từ chương trình con lồng bên trong.

Phần tử mảng

Kiểu của phần tử mảng bị bỏ qua và có thể lược bỏ, vì vậy hai khai báo sau là tương đương:

Var
x : array [1..2] of double;

Var
x : array [1..2];

Lưu ý rằng bạn không thể khai báo kiểu mảng, nhưng có thể khai báo biến mảng.

Illegal example:

Type
TVertices = Array [1..50] Of TLocation;
Var
NewVertices : TVertices;

Legal example:

Var
NewVertices : Array [1..50] of TLocation;

Khai báo mảng mở

Khai báo Open Array không được hỗ trợ.

Từ khóa Case

Từ khóa Case có thể được sử dụng với mọi kiểu. Vì vậy, đoạn mã sau là hợp lệ:

Case UserName of
'Alex', 'John' : IsAdministrator := true;
'Peter' : IsAdministrator := false;
Else
Raise('Unknown user');
End;

Khai báo lớp

Không thể định nghĩa lớp mới trong DelphiScript, nhưng bạn có thể sử dụng và khởi tạo các lớp DelphiScript hiện có. Ví dụ, có thể tạo và sử dụng các lớp TList và TStringList trong script của bạn.
See also
TList
TStringList

Hàm CreateObject

Hàm CreateObject có thể được dùng để tạo các đối tượng sẽ được tự động giải phóng khi không còn được sử dụng.

Vì vậy, thay vì:

Procedure Proc;
Var
  l;
Begin
    l := TList.Create;
  Try
    // do something with l
  Finally
  L.Free;
End;

...bạn có thể viết:

Procedure Proc;
Var
  l;
Begin
  l := CreateObject(TList);
  // Do something with l
End;

See also
Hàm CreateObject.

Phát sinh ngoại lệ

Có thể sử dụng từ khóa Raise mà không cần tham số để phát sinh lại ngoại lệ gần nhất. Raise cũng có thể được dùng với một tham số chuỗi để phát sinh ngoại lệ kèm chuỗi thông báo được chỉ định. Các đối tượng Exception không được hỗ trợ trong DelphiScript vì từ khóa On không được hỗ trợ.

Example:

Raise(Format('Invalid value : %d', [Height]));

See also
Các từ khóa Try, Finally và Raise.

ThreadVar

Trong DelphiScript, từ khóa Threadvar được xử lý như Var. Lưu ý rằng trong Embarcadero Delphi, các biến được khai báo bằng từ khóa Threadvar có giá trị riêng biệt trong từng luồng.

Toán tử tập hợp

Toán tử tập hợp In không được hỗ trợ. Có thể sử dụng toán tử InSet để kiểm tra xem một giá trị có phải là phần tử của một tập hợp hay không. Ví dụ:

If InSet(fsBold, Font.Style) then
ShowMessage('Bold');

Lưu ý rằng các toán tử tập hợp Delphi +, -, *, <=, >= không hoạt động chính xác. Thay vào đó, các hàm DelphiScript tích hợp sẵn MkSet, MkSetRange, SetUnion, SetDifference, SetIntersection, SubSet and InSet được sử dụng:

ASet := BSet + CSet; \\ should be changed to
ASet := SetUnion(BSet, CSet);

Các cấu trúc tạo tập hợp [...] không được hỗ trợ — hãy sử dụng hàm MkSet để tạo một tập hợp:

Font.Style := MkSet(fsBold, fsItalic); 

See also
Từ khóa MkSet
Từ khóa MkSetRange
Từ khóa InSet
Từ khóa SetDifference
Từ khóa SetIntersection
Từ khóa SetUnion
Từ khóa SubSet
Từ khóa InSet

Toán tử

Các toán tử ^ và @ không được hỗ trợ.

Chỉ thị

Các chỉ thị sau không được hỗ trợ (lưu ý rằng một số chỉ thị đã lỗi thời và cũng không được Embarcadero Delphi hỗ trợ): absolute, abstract, assembler, automated, cdecl, contains, default, dispid, dynamic, export, external, far, implements, index, message, name, near, nodefault, overload, override, package, pascal, private protected, public, published, read, readonly, register, reintroduce, requires, resident, safecall, stdcall, stored, virtual, write, writeonly.

Ngoài ra, lưu ý rằng chỉ thị in trong mệnh đề Uses sẽ bị bỏ qua.

Từ khóa bị bỏ qua

Các từ khóa interface, implementation, program và unit bị bỏ qua trong DelphiScript. Script có thể chứa chúng nhưng chúng không có tác dụng — tuy nhiên, các từ khóa này có thể giúp script dễ đọc hơn.

Từ khóa không được hỗ trợ

Các từ khóa sau không được hỗ trợ trong DelphiScript:

  • as, asm, class, dispinterface, exports, finalization, inherited, initialization, inline, interface, is, library, object, out, property, record, resourcestring, set, supports, type.

Các hàm Delphi RTL sau không được hỗ trợ trong DelphiScript:

  • Abort, Addr, Assert, Dec, FillChar, Finalize, Hi, High, Inc, Initialize, Lo, Low, New, Ptr, SetString, SizeOf, Str, UniqueString, VarArrayRedim, VarArrayRef, VarCast, VarClear, VarCopy.

Các hàm thuộc unit Windows của Delphi (tệp windows.pas) không được hỗ trợ (ví dụ, hàm RGB không được hỗ trợ).

Sử dụng API Altium Designer trong script

Bạn không thể tự tạo các kiểu bản ghi hoặc lớp bằng DelphiScript rồi khởi tạo chúng trong script; tuy nhiên, bạn có thể sử dụng một số lớp của API Altium Designer. Ví dụ, các lớp TStringList và TList có thể được khởi tạo và dùng làm vùng chứa để lưu trữ dữ liệu (thường có cùng kiểu) nhằm đáp ứng nhu cầu của script.

Các giao diện đối tượng của API, đại diện cho các đối tượng Altium Designer, có thể được sử dụng trong script. Ví dụ, bạn có thể cập nhật các đối tượng thiết kế trên tài liệu sơ đồ nguyên lý và PCB thông qua các giao diện đối tượng sơ đồ nguyên lý và giao diện đối tượng PCB.

Theo quy ước, tên giao diện có thêm chữ 'I' ở đầu. Ví dụ, IPCB_Board đại diện cho giao diện của một tài liệu PCB hiện có.

Ví dụ về giao diện PCB trong script:

Procedure ViaCreation;
Var
  Board : IPCB_Board;
  Via : IPCB_Via;
Begin
  Board := PCBServer.GetCurrentPCBBoard;
  If Board = Nil Then Exit;
 
  (\* Create a Via object\* )
  Via           := PCBServer.PCBObjectFactory(eViaObject, eNoDimension, eCreate_Default);
  Via.X         := MilsToCoord(7500);
  Via.Y         := MilsToCoord(7500);
  Via.Size      := MilsToCoord(50);
  Via.HoleSize  := MilsToCoord(20);
  Via.LowLayer  := eTopLayer;
  Via.HighLayer := eBottomLayer;
 
  (* Put this via in the Board object*)
  Board.AddPCBObject(Via);
End;

Có thể sử dụng các API sau trong script:

  • Một số hàm và lớp của Embarcadero Delphi™, cùng các phần mở rộng của DelphiScript
  • API máy khách
  • API máy chủ PCB
  • API máy chủ sơ đồ nguyên lý
  • API máy chủ quản lý không gian làm việc
  • API thư viện tích hợp
  • Các hàm API Altium Designer
  • Các quy trình có tham số

Thông tin thêm

Hãy xem các script trong bộ sưu tập script có thể tải xuống để biết cách sử dụng các giao diện đối tượng và hàm của Altium Designer, cũng như các đối tượng và hàm Delphi trong script.

Tham khảo tài liệu chính về Viết tập lệnh để biết thông tin về cách viết tập lệnh cho Altium Designer.

Tham khảo hướng dẫn Sử dụng API của Altium Designer để biết chi tiết về cách sử dụng các đối tượng thiết kế và giao diện của chúng trong tập lệnh của bạn.

Tham khảo Tài liệu tham chiếu API của Altium Designer để biết thông tin về các API của Altium Designer và các đối tượng giao diện của chúng dùng cho tập lệnh.

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