Công cụ Chỉnh sửa Script

Sơ lược

Khám phá các công cụ chỉnh sửa và gỡ lỗi tập lệnh có trong Altium Designer, từ tô sáng cú pháp có thể tùy chỉnh và mẫu mã đến tự động hoàn thành mã theo ngữ cảnh và điểm dừng. Bài viết này giải thích cách truy cập các tính năng đó, điều hướng đến các định nghĩa trong tập lệnh và xem tham số của phương thức để hỗ trợ quy trình viết tập lệnh của bạn. Trang này cũng cung cấp thông tin chi tiết về các công cụ chỉnh sửa văn bản thông dụng hiện có. Hãy đọc tiếp để áp dụng những công cụ này vào tập lệnh tiếp theo của bạn.

- Tìm hiểu cách cấu hình liên kết ngôn ngữ, tô sáng cú pháp và các mẫu mã có thể tái sử dụng.
- Khám phá các phím tắt để tự động hoàn thành mã, hiển thị gợi ý tham số của phương thức và điều hướng đến định nghĩa của biến và thủ tục.
- Nắm được cách thêm, bật/tắt và cấu hình điểm dừng có điều kiện để kiểm tra quá trình thực thi tập lệnh.
Tìm hiểu sâu hơn với AI:
 

Hệ thống lập trình script của Altium Designer gồm hai phần chính – trình soạn thảo và trình gỡ lỗi. Trình soạn thảo cung cấp nhiều tính năng hỗ trợ và kiểm tra mã script, còn trình gỡ lỗi cho phép truy cập các thành phần script và các tính năng gỡ lỗi.

Công cụ lập trình script

Hệ thống lập trình script cung cấp nhiều công cụ giúp bạn viết và gỡ lỗi script. Bên cạnh khả năng tự động hoàn thành và phân tích mã, hệ thống còn cho phép bạn tương tác để thực thi từng dòng script, kiểm tra các biến và đối tượng, cũng như đặt điểm dừng trên một hoặc nhiều dòng trong script.

Các công cụ của trình soạn thảo script hỗ trợ đắc lực khi gỡ lỗi script.

Thiết lập ngôn ngữ

Từ hộp thoại Language Setup, bạn có thể tạo, chỉnh sửa và quản lý danh sách các ngôn ngữ có thể liên kết với tài liệu được mở trong một biến thể hỗ trợ mã lập trình của Trình soạn thảo văn bản. Mỗi ngôn ngữ gồm một bộ quy tắc cú pháp, một tập hợp các mẫu mã và danh sách các liên kết tệp. Để truy cập hộp thoại, hãy nhấp vào  trên thanh công cụ Text Utilities .

Hộp thoại Language Setup
Hộp thoại Language Setup

Hộp thoại chứa danh sách các ngôn ngữ hiện đã được định nghĩa. Sử dụng hộp thoại để tạo, sao chép, sửa đổi và xóa ngôn ngữ theo nhu cầu. Với mỗi ngôn ngữ, cần định nghĩa những mục sau:

  • Mỗi phần mở rộng tệp chỉ được ánh xạ tới một ngôn ngữ. Nếu bạn thêm cùng phần mở rộng đó vào một ngôn ngữ khác, ánh xạ tới ngôn ngữ cũ sẽ tự động bị xóa.
  • Nếu một tệp có phần mở rộng cụ thể được liên kết với một ngôn ngữ, nội dung tệp sẽ được tô sáng theo cú pháp đã định nghĩa cho ngôn ngữ đó.
  • Khi sao chép một ngôn ngữ, bạn cũng sao chép bộ quy tắc cú pháp cùng tất cả các mẫu mã có trong ngôn ngữ đó.

Tô sáng cú pháp

Tô sáng cú pháp là phương pháp giúp tài liệu văn bản dễ đọc hơn bằng cách tô sáng các thành phần khác nhau trong tài liệu dựa trên cú pháp của chúng. Phương pháp này gán màu riêng cho các từ, ký hiệu và định danh khác nhau. Tập hợp các quy tắc gán màu này được gọi là cú pháp của ngôn ngữ đó.

Bộ quy tắc cú pháp cho ngôn ngữ liên kết với tài liệu hiện tại có thể được định nghĩa/chỉnh sửa trong hộp thoại Syntax Editor, được truy cập từ Trình soạn thảo văn bản (hoặc bất kỳ biến thể nào hỗ trợ mã lập trình của Trình soạn thảo văn bản), bằng cách nhấp vào nút  trên thanh công cụ Text Utilities .

Hộp thoại Syntax Editor
Hộp thoại Syntax Editor

Mặc dù lệnh này thường có sẵn trên thanh công cụ Text Utilities, hãy lưu ý rằng các tệp văn bản tiêu chuẩn (*.txt) không được liên kết với ngôn ngữ nào, do đó không thể truy cập hộp thoại từ bên trong tài liệu thuộc loại này.

Hộp thoại Syntax Editor được chia thành năm tab, mỗi tab đại diện cho một nhóm cú pháp khác nhau của ngôn ngữ:

  • Options - dùng để định nghĩa các tùy chọn cú pháp chung.
  • Comments - dùng để định nghĩa chú thích. Chú thích là những thành phần trong tệp văn bản mà bạn muốn xác định là chú thích trong mã. Chúng có thể được định nghĩa là chú thích một dòng, toàn dòng hoặc nhiều dòng. Chú thích được định nghĩa bằng các dấu phân cách, tức là những ký tự cho biết một khối văn bản là chú thích. Chú thích một dòng và toàn dòng chỉ cần dấu phân cách bên trái (đầu còn lại được xác định bằng ký tự kết thúc dòng EOL). Chú thích một dòng có thể bắt đầu ở bất kỳ vị trí nào trên dòng, còn chú thích toàn dòng yêu cầu dấu phân cách chú thích phải là ký tự đầu tiên trên dòng. Chú thích nhiều dòng cần có dấu phân cách bên trái và bên phải để xác định vị trí bắt đầu và kết thúc.
  • Strings - dùng để định nghĩa chuỗi. Chuỗi là những thành phần trong tệp văn bản mà bạn muốn xác định là chuỗi trong mã, chẳng hạn như chuỗi xuất hiện dưới dạng thông báo trong hộp thoại do chương trình hiển thị. Cả chuỗi một dòng và nhiều dòng đều được hỗ trợ, và cả hai loại đều cần dấu phân cách bên trái và bên phải để xác định điểm bắt đầu và kết thúc.
  • Numbers - dùng để định nghĩa số. Giống như chú thích và chuỗi, số là một nhóm thông tin khác trong tài liệu mà bạn có thể muốn làm nổi bật. Simple numbers được định nghĩa là các chuỗi chữ số, có thể có hoặc không có dấu thập phân, ví dụ: 45, 45.6 nhưng không phải 45.6.6. Số đơn giản cũng có thể bao gồm ký tự E để biểu thị ký pháp khoa học, chẳng hạn như 53E3 hoặc 24e6. Special numbers được định nghĩa là có tiền tố và/hoặc hậu tố, đồng thời chứa các chữ số hoặc các chữ cái A-F. Ví dụ, chúng có thể được dùng để cho trình biên dịch biết số đó ở hệ thập lục phân hay bát phân. Ví dụ về các số này gồm 0xAF034AD, 88j, j8A8y, nhưng không bao gồm 0xA.4. Mỗi loại số được xác định bằng hậu tố, tiền tố hoặc sự kết hợp cả tiền tố và hậu tố. Nguyên tắc hoạt động cơ bản của tiền tố và hậu tố là bất cứ khi nào phát hiện một tiền tố hoặc hậu tố hợp lệ kết hợp với một số, cả số và tiền tố (hoặc hậu tố) đó sẽ được tô sáng theo kiểu định dạng số. Có thể điều chỉnh nguyên tắc hoạt động cơ bản này thông qua các tùy chọn bổ sung có sẵn.
  • Keywords - dùng để định nghĩa từ khóa. Từ khóa là tập hợp các từ được định nghĩa trước mà bạn muốn làm nổi bật trong tài liệu. Thông thường, đây là các từ dành riêng của ngôn ngữ lập trình để xác định một hàm, thủ tục, kiểu đối tượng cụ thể, v.v. Từ khóa được định nghĩa trong một hoặc nhiều bộ từ khóa, mỗi bộ có kiểu định dạng riêng (các tham số màu sắc và phông chữ), giúp tài liệu dễ đọc hơn nữa.
  • Bật/tắt tính năng tô sáng cú pháp cho từng thành phần cú pháp trong tab tương ứng. Nếu tùy chọn tô sáng của một thành phần cú pháp bị tắt, mọi cú pháp thuộc loại đó trong tài liệu sẽ không còn được tô sáng và sẽ trở về kiểu định dạng của văn bản thông thường.
  • Nếu cùng một từ khóa xuất hiện trong nhiều bộ từ khóa, kiểu tô sáng của bộ xuất hiện đầu tiên trong danh sách sẽ được áp dụng.
  • Từ khóa có thể chứa chữ cái, chữ số và ký tự gạch dưới. Từ khóa không được bắt đầu bằng chữ số.

Hoàn thành mã

Trình soạn thảo hỗ trợ tính năng hoàn thành mã, tự động hiển thị cửa sổ bật lên với các tùy chọn mã phù hợp với ngữ cảnh.

Khi bạn nhập dấu chấm sau tên giao diện đối tượng, danh sách các thuộc tính và phương thức khả dụng cho đối tượng đó sẽ xuất hiện trong cửa sổ menu hoàn thành mã bật lên – tiếp tục nhập để thu hẹp danh sách. Khi bạn chọn một tùy chọn trong danh sách, thủ tục/hàm hoặc thuộc tính đó sẽ được chèn vào mã.

Bạn có thể dùng tổ hợp phím tắt Ctrl+Space để mở cửa sổ danh sách Hoàn thành mã bất cứ lúc nào.

Danh sách Hoàn thành mã cũng bao gồm các thủ tục và hàm toàn cục có sẵn trong dự án hiện đang mở, kể cả những thủ tục và hàm trong script hiện tại.

Tính năng Hoàn thành mã cực kỳ hữu ích khi chọn đúng giao diện đối tượng, phương thức và thuộc tính để sử dụng trong script.

Mẫu câu lệnh

Mẫu mã là các khối mã được định nghĩa sẵn, có thể tự động chèn vào tệp văn bản có hỗ trợ lập trình và là công cụ hỗ trợ nâng cao năng suất rất hữu ích khi bạn viết mã bằng một ngôn ngữ cụ thể. Mỗi mẫu mã có ba thuộc tính: tên, mô tả và đoạn mã thực tế sẽ được mẫu chèn vào.

Tính năng mẫu tập lệnh sẽ tự động tạo cấu trúc mã cho câu lệnh được chọn từ cửa sổ danh sách bật lên.

Bạn có thể kích hoạt danh sách bật lên bất cứ lúc nào bằng tổ hợp phím tắt Ctrl+J , nút Show Code Templates ( trên thanh công cụ Text Utilities) hoặc lệnh Tools » Show Code Templates từ các menu chính. Nếu được kích hoạt sau khi bạn nhập vài chữ cái đầu tiên của một câu lệnh, chẳng hạn như 'proc', mã câu lệnh tương ứng sẽ tự động được điền vào tài liệu với cấu trúc Procedure. Ngoài ra, nếu có nhiều câu lệnh phù hợp với các chữ cái đã nhập (ví dụ: 'if'), cửa sổ danh sách mẫu sẽ hiển thị danh sách câu lệnh đã được lọc.

Bạn cũng có thể đặt con trỏ tại vị trí mong muốn trong tệp rồi gọi lệnh. Một cửa sổ bật lên sẽ xuất hiện, liệt kê tất cả các mẫu mã hiện có được định nghĩa cho ngôn ngữ tương ứng. Chọn mục mong muốn để chèn mẫu đó.

Mỗi mẫu mã được nhận diện bằng tên, như được chỉ định trong hộp thoại Code Templates Editor. Bạn có thể truy cập hộp thoại này từ hộp thoại Language Setup (nhấp vào  trên thanh công cụ Text Utilities ), bằng cách chọn lệnh Templates từ Menu.

Tham số phương thức

Tính năng Tham số phương thức tập lệnh hiển thị thông báo bật lên cho biết các tham số được sử dụng cho một phương thức cụ thể (hàm/thủ tục, v.v.) của giao diện đối tượng.

Khi bạn nhập dấu ngoặc tròn mở ngay sau một phương thức, như trong hình bên dưới, thông báo Tham số sẽ tự động xuất hiện. Bạn có thể dùng tổ hợp phím Shift+Ctrl+Space để hiển thị thủ công thông báo bật lên Tham số, khi áp dụng được.

Để xem định nghĩa tham số của một câu lệnh phương thức đã hoàn chỉnh, hãy đặt con trỏ bên trong cặp dấu ngoặc chứa tham số rồi dùng Shift+Ctrl+Space để gọi thông báo bật lên.

Thông báo bật lên Tham số cũng hiển thị vị trí mã nguồn của định nghĩa phương thức (hàm/thủ tục), khi có. Trong ví dụ trên, phương thức (ShowAParametricMessage) được định nghĩa trong tập lệnh HelloWorld.pas tại dòng 14 – di chuột lên hình để xem cách phương thức được sử dụng trong tập lệnh HelloWorldDialog.

Điều hướng đến định nghĩa

Bạn có thể tìm ngay vị trí mã nguồn định nghĩa biến hoặc phương thức trong tập lệnh bằng tính năng Điều hướng của trình soạn thảo.

Để tìm mã nguồn định nghĩa một biến, hãy giữ phím Ctrl trong khi nhấp vào biến tại nơi biến được sử dụng trong tập lệnh. Con trỏ sẽ chuyển đến định nghĩa. Sử dụng cách tương tự (Ctrl+Click) để tìm mã nguồn định nghĩa một thủ tục. Nếu thủ tục được định nghĩa trong một tập lệnh khác thuộc dự án, tập lệnh đó sẽ mở ra với con trỏ đặt tại thủ tục.

Chú giải Insight

Tính năng Chú giải Insight hiển thị kiểu của biến khi con trỏ chuột di lên biến đó. Tương tự, khi di chuột lên một thủ tục, định nghĩa và vị trí của thủ tục đó (tập lệnh và số dòng) sẽ được hiển thị.

Điểm ngắt

Điểm ngắt là công cụ gỡ lỗi chủ yếu, cho phép bạn tạm dừng việc thực thi tập lệnh tại các vị trí được xác định trước. Một cách sử dụng điểm ngắt điển hình là trong các nhánh khác nhau của câu lệnh điều kiện, trong đó mỗi nhánh được chèn một điểm ngắt để kiểm tra nhánh nào được thực thi.

Cách đơn giản nhất để đặt điểm ngắt là nhấp vào vùng lề của trình soạn thảo bên cạnh một dòng mã; dòng đó sẽ được tô đỏ. Dòng được tô sáng sẽ chuyển sang màu xanh đậu khi tập lệnh đang chạy gặp điểm ngắt đó. Bạn có thể cho tập lệnh chạy đến điểm ngắt tiếp theo bằng lệnh Run (phím tắt: F9) hoặc các lệnh thực thi từng bước.

Để bật/tắt điểm ngắt cho dòng hiện tại, bạn cũng có thể dùng lệnh Run » Toggle Breakpoint từ các menu chính (phím tắt: F5).

Ngoài ra, hãy dùng lệnh Run » Add Breakpoint từ các menu chính để mở hộp thoại Add New Breakpoint, nơi bạn có thể định nghĩa một điểm ngắt mới để thêm vào bất kỳ tài liệu tập lệnh nào hiện đang mở. Sử dụng hộp thoại này để chỉ định số dòng trong tài liệu đã chọn mà điểm ngắt sẽ được thêm vào. Trường Condition trong hộp thoại cho phép bạn định nghĩa điểm ngắt có điều kiện, theo đó việc thực thi tập lệnh chỉ dừng lại nếu điều kiện gắn với điểm ngắt trả về giá trị đúng; nếu không, tập lệnh sẽ tiếp tục thực thi mà không bị gián đoạn.

Bạn cũng có thể chọn trạng thái ban đầu của điểm ngắt là bật hay tắt. Điểm ngắt bị tắt vẫn được định nghĩa nhưng sẽ không khiến tập lệnh đang chạy dừng lại khi gặp nó. 

  • Điểm ngắt đang bật được biểu thị trong mã bằng dòng điểm ngắt được tô đỏ và một hình tròn màu đỏ có dấu chéo ở lề (). Điểm ngắt bị tắt được biểu thị trong mã bằng dòng điểm ngắt được tô xanh lá và một hình tròn màu xanh lá có dấu chéo ở lề ().
  • Không thể xóa trực tiếp điểm ngắt bị tắt khỏi tài liệu tập lệnh. Ở trạng thái bị tắt, điểm ngắt chỉ có thể được xóa từ bảng Điểm ngắt.

Hộp thoại Add New Breakpoint
Hộp thoại Add New Breakpoint

Lưu ý rằng điểm ngắt trong tập lệnh phải nằm trên một dòng câu lệnh. Mọi điểm ngắt được đặt trên dòng trống, dòng chú thích hoặc các dòng không phải câu lệnh khác đều sẽ bị bỏ qua.

Bạn có thể truy cập các điểm ngắt qua bảng Breakpoints để dễ dàng tìm và quản lý tất cả các điểm ngắt đã đặt mà không cần duyệt qua tập lệnh để tìm chúng. Bảng này cung cấp thông tin về tất cả các điểm ngắt hiện được định nghĩa trong mọi tệp tập lệnh đang mở (bất kể chúng thuộc dự án tập lệnh (*.PrjScr) nào), đồng thời cung cấp các lệnh để thêm, bật, tắt và xóa các điểm ngắt đã chọn theo nhu cầu từ menu chuột phải.

Bảng Breakpoints
Bảng Breakpoints

Nhấp đúp vào một mục điểm ngắt trong bảng (hoặc chọn lệnh Edit Source từ menu chuột phải) để đưa tài liệu tập lệnh tương ứng thành tài liệu đang hoạt động trong không gian thiết kế, đồng thời đặt con trỏ văn bản tại đầu dòng tập lệnh có điểm ngắt đó.

Chọn lệnh Properties từ menu chuột phải để truy cập hộp thoại Breakpoint Properties cho mục điểm ngắt đã chọn. Bạn có thể dùng hộp thoại này để thay đổi trạng thái của điểm ngắt (bật/tắt), đồng thời thêm/sửa điều kiện cho điểm ngắt theo nhu cầu. Bạn không thể thay đổi tệp đã được thêm điểm ngắt, cũng như số dòng cụ thể trong tệp đó.

Hộp thoại Breakpoint Properties
Hộp thoại Breakpoint Properties

Đánh giá biểu thức

Khi một tập lệnh dừng do gặp điểm ngắt hoặc lỗi, bạn có thể xác định giá trị của bất kỳ biểu thức nào (một câu lệnh trong tập lệnh) bằng tính năng Chú giải hoặc qua hộp thoại tương tác Evaluate .

Các công cụ Đánh giá chủ yếu là công cụ gỡ lỗi, được sử dụng kết hợp với các bảng hỗ trợ gỡ lỗi như Watch List và Call Stack.

Chú giải đánh giá biểu thức

Tính năng chú giải đánh giá biểu thức hiển thị giá trị dữ liệu hiện tại của biến mà con trỏ đang di chuột lên.

Tính năng đánh giá

Để sử dụng hộp thoại Evaluate của trình soạn thảo, hãy nhấp vào một biến trong biểu thức của tập lệnh và chọn nút Run » Evaluate (phím tắt: Ctrl+F7). Hộp thoại sẽ tự động được điền biểu thức và kết quả hiện tại của biểu thức đó.

Ngoài ra, bạn có thể sao chép một biểu thức từ tập lệnh vào trường Expression của hộp thoại rồi nhấp vào Evaluate để xem kết quả. Bạn cũng có thể nhập trực tiếp tên biểu thức vào trường Expression để đánh giá kết quả.

Một tập lệnh ở chế độ điểm ngắt với hộp thoại Evaluate  được kích hoạt.
Một tập lệnh ở chế độ điểm ngắt với hộp thoại Evaluate được kích hoạt.

Biểu thức theo dõi

Biểu thức theo dõi cho phép bạn theo dõi giá trị của biến/biểu thức khi gỡ lỗi từng bước trong tài liệu tập lệnh hiện tại. Biểu thức theo dõi có thể là một biến đơn lẻ hoặc một biểu thức chứa một hay nhiều biến.

Để xác định các biểu thức theo dõi cho tài liệu tập lệnh hiện tại, hãy sử dụng lệnh Run » Add Watch từ các menu chính (phím tắt: Ctrl+F5). Sau khi chạy lệnh, hộp thoại Add New Watch sẽ xuất hiện. Sử dụng hộp thoại này để xác định biểu thức bạn muốn theo dõi. Ví dụ, biểu thức có thể là một biến cụ thể được sử dụng trong mã (ví dụ: OUT, a, Remainder), hoặc một biểu thức dựa trên một hay nhiều biến đã được xác định (ví dụ: a+b, a*b, c+(b-a)).

Hộp thoại Add New Watch
Hộp thoại Add New Watch

Sau khi nhấp vào OK, biểu thức theo dõi sẽ xuất hiện trong bảng Watch List. Sử dụng bảng này để xem đồng thời tất cả các biểu thức theo dõi đã xác định. Bạn có thể thêm, chỉnh sửa và xóa các mục theo dõi từ menu bật lên khi nhấp chuột phải trong bảng.

Bảng Watch List
Bảng Watch List

Khi bạn thực thi từng dòng mã trong tài liệu tập lệnh, các biểu thức theo dõi sẽ được đánh giá và các giá trị tương ứng sẽ được cập nhật nếu tập lệnh thay đổi bất kỳ biến nào được sử dụng trong các biểu thức đó.

Khi quá trình thực thi tập lệnh đi vào một hàm hoặc thủ tục, biểu thức theo dõi chỉ hợp lệ nếu các biến trong biểu thức được định nghĩa và sử dụng trong hàm hoặc thủ tục đó. Nếu một biến không khả dụng đối với hàm hoặc thủ tục (tức là không phải biến toàn cục hoặc là biến cục bộ của một phần khác trong tập lệnh), trường Value sẽ hiển thị Undeclared identifier: VariableName.

Nhấp đúp vào một mục theo dõi trong bảng hoặc nhấp chuột phải vào mục đó và chọn lệnh Edit Watch để truy cập hộp thoại Watch Properties, nơi bạn có thể chỉnh sửa biểu thức cho mục theo dõi đã chọn theo yêu cầu.

Dấu trang

Dấu trang được sử dụng trong tập lệnh để đánh dấu các câu lệnh và điều hướng nhanh đến chúng. Có thể xác định tối đa 10 dấu trang trong một tập lệnh.

Dấu trang được biểu thị bằng một ô màu xanh lá cây ở lề trình soạn thảo, bên trong có số của dấu trang. Để thêm dấu trang, hãy chọn một dòng mã, nhấp chuột phải, chọn Toggle Bookmarks từ menu ngữ cảnh, rồi chọn một số vị trí từ menu con (Toggle Bookmarks » Set Location Mark n, trong đó 'n' là số dấu trang từ 0 đến 9).

Để đi đến (nhảy đến) một dấu trang, hãy nhấp chuột phải rồi chọn Goto Bookmarks và vị trí dấu trang mong muốn từ menu con (Goto Bookmarks » Jump Location Mark n). Để xóa dấu trang, hãy tắt dấu trang bằng cách lặp lại quy trình thêm dấu trang cho dòng mã đó.

Vị trí đã lưu chỉ khả dụng khi tài liệu vẫn đang mở (dù có đang hoạt động hay không). Nếu đóng rồi mở lại tài liệu, dấu đánh dấu vị trí sẽ bị xóa.

Sử dụng dấu trang để nhảy nhanh đến một câu lệnh trong tập lệnh.
Sử dụng dấu trang để nhảy nhanh đến một câu lệnh trong tập lệnh.

  • Sử dụng tổ hợp phím tắt Ctrl+n để nhảy đến một dấu trang hiện có trong tập lệnh (trong đó n là số dấu trang từ 0 đến 9) — ví dụ, để đến dấu trang số 3, hãy nhấn tổ hợp phím tắt Ctrl+3.
  • Sử dụng tổ hợp phím tắt Ctrl+Shift+n để bật/tắt dấu trang (trong đó n là số dấu trang cần bật/tắt), hoặc chuyển một dấu trang đã gán đến dòng hiện tại.

Thu gọn mã

Để thuận tiện khi làm việc với mã, các thủ tục/hàm/chương trình con trong tài liệu được tổ chức thành các khối mã có thể thu gọn. Bạn có thể thu gọn hoặc mở rộng các khối mã để chỉ hiển thị nội dung tài liệu cần thiết tại thời điểm đó. 

Việc sử dụng tính năng thu gọn mã, bao gồm tùy chọn hiển thị các đường chỉ phạm vi thu gọn — phạm vi của từng khối mã — được bật/tắt trên trang Text Editors - Display của hộp thoại Preferences.

Để mở rộng/thu gọn một khối mã riêng lẻ, hãy nhấp vào nút điều khiển nhỏ  hoặc  ở bên trái câu lệnh đầu tiên trong khối. Khi được thu gọn, nút điều khiển  sẽ xuất hiện ở bên phải câu lệnh đầu tiên của mỗi khối mã. Di chuột lên nút này sẽ hiển thị phần mã đã bị thu gọn. Nhấp đúp vào nút điều khiển này sẽ mở rộng khối mã tương ứng.

Để mở rộng/thu gọn tất cả các khối mã trong tài liệu hiện tại, hãy nhấp chuột phải và chọn Outlining » Collapse All hoặc Expand All từ menu ngữ cảnh.

Các công cụ chỉnh sửa văn bản chung

Thêm mục việc cần làm

Mục việc cần làm, đúng như tên gọi, về cơ bản được dùng để nhắc nhở về một tác vụ liên quan đến tài liệu cần được thực hiện sau này.

Để thêm một mục việc cần làm tại một vị trí trong tài liệu hiện tại, hãy đặt con trỏ văn bản tại vị trí đó, nhấp chuột phải và chọn Add To-Do Item từ menu ngữ cảnh. Sau khi chạy lệnh, hộp thoại Edit To-Do Item sẽ xuất hiện. Sử dụng hộp thoại này để nhập nội dung phù hợp về tác vụ cần thực hiện tại vị trí đó trong tài liệu. Sử dụng các trường có sẵn trong hộp thoại để xác định Priority cho tác vụ (từ Thấp nhất đến Cao nhất, với Normal được chọn theo mặc định), Owner của tác vụ và cả Category cho tác vụ (ví dụ: lượt định dạng, lượt rà soát mã, v.v.).

Sau khi xác định mục việc cần làm theo yêu cầu, nhấp vào OK sẽ đóng hộp thoại và đưa tiêu điểm trở lại tài liệu hiện tại. Một mục việc cần làm sẽ xuất hiện tại vị trí con trỏ văn bản hiện tại. Mục này sẽ xuất hiện  giữa các dấu phân cách { và }, như minh họa trong ví dụ bên dưới:

{TODO Name=Check Spelling|Priority=3|State=1|Owner=Jase|Category=Proofing|UID=UIDYOGFS}

Trong đó:

  • Name là nội dung thực tế của hành động cần thực hiện.
  • Priority là giá trị biểu thị mức ưu tiên được gán (Lowest = 0, Low = 1, High = 3, Highest = 4). Nếu Priority được đặt thành Normal, mục này sẽ không được hiển thị.
  • State phản ánh liệu mục công việc đã được hoàn thành hay chưa. Nếu chưa, sẽ không có giá trị nào được hiển thị. Nếu đã hoàn thành, giá trị của State sẽ là 1.
  • Owner là người được giao phụ trách mục công việc.
  • Category là danh mục được gán cho mục công việc.
  • UID là mã định danh duy nhất của mục công việc đó.
Tất cả các mục công việc cần làm của dự án đang hoạt động được liệt kê trong bảng To-Do.

Thay đổi chữ hoa/chữ thường hoặc viết hoa chữ cái đầu

Các lệnh trong menu Tools » Change Case cho phép bạn thay đổi kiểu chữ hoa/chữ thường hoặc cách viết hoa của văn bản được chọn hay từ tại vị trí con trỏ.

  • Selection To UpperCase – chọn văn bản mà bạn muốn chuyển từ kiểu chữ lower sang UPPER rồi chạy lệnh. Phần văn bản được chọn sẽ được chuyển thành chữ hoa.
  • Selection To LowerCase – chọn văn bản mà bạn muốn chuyển từ kiểu chữ UPPER sang lower rồi chạy lệnh. Phần văn bản được chọn sẽ được chuyển thành chữ thường.
  • Capitalize Selection – chọn văn bản mà bạn muốn viết hoa chữ cái đầu rồi chạy lệnh. Chữ cái đầu của mỗi từ trong phần văn bản được chọn sẽ được chuyển thành chữ hoa nếu từ đó chưa bắt đầu bằng chữ hoa.
  • Word To UpperCase – đặt con trỏ văn bản ở đầu, cuối hoặc bất kỳ vị trí nào trong từ mà bạn muốn chuyển từ kiểu chữ lower sang UPPER rồi chạy lệnh. Từ đó sẽ được chuyển thành chữ hoa.
  • Word To LowerCase – đặt con trỏ văn bản ở đầu, cuối hoặc bất kỳ vị trí nào trong từ mà bạn muốn chuyển từ kiểu chữ UPPER sang lower rồi chạy lệnh. Từ đó sẽ được chuyển thành chữ thường.
  • Capitalize Word – đặt con trỏ văn bản ở đầu, cuối hoặc bất kỳ vị trí nào trong từ mà bạn muốn viết hoa chữ cái đầu rồi chạy lệnh. Chữ cái đầu của từ đó sẽ được chuyển thành chữ hoa.

Thụt lề văn bản

Để tài liệu dễ đọc hơn, bạn có thể áp dụng thụt lề văn bản. Để tăng hoặc giảm thụt lề cho văn bản được chọn trong tài liệu hiện tại, hãy chọn Tools » Indent hoặc Tools » Unindent từ các menu chính hoặc nhấp vào nút  / trên thanh công cụ Text Utilities. Phần văn bản được chọn sẽ được tăng/giảm thụt lề theo số ký tự được chỉ định trong trường Block Indent, trên trang Text Editors - General của hộp thoại Preferences.

Nếu tùy chọn Backspace unindents được bật (trên trang Text Editors - General của hộp thoại Preferences ), bạn có thể giảm thụt lề bằng phím Backspace . Đặt con trỏ văn bản trước ký tự không phải dấu cách đầu tiên trên dòng cần giảm thụt lề rồi nhấn Backspace. Dòng đó sẽ được giảm thụt lề, căn theo vị trí bắt đầu của các từ trên dòng trước.

Tìm kiếm và thay thế văn bản

Hộp thoại Find Text được dùng để cấu hình tìm kiếm văn bản cụ thể trong tài liệu hiện tại, tất cả tài liệu dạng văn bản trong dự án đang hoạt động, tất cả tài liệu dạng văn bản đang mở hoặc tất cả tài liệu dạng văn bản trong một thư mục được chỉ định. Bạn có thể truy cập hộp thoại này từ Trình soạn thảo văn bản (hoặc bất kỳ biến thể nào có hỗ trợ nhận diện mã của Trình soạn thảo văn bản) bằng cách chọn lệnh Edit » Find từ các menu chính (phím tắt: Ctrl+F).

Hộp thoại Find Text 
Hộp thoại Find Text

Về cơ bản, hộp thoại hoạt động ở hai chế độ, với các chức năng được cung cấp qua hai thẻ:

  • Find - sử dụng các tùy chọn trên thẻ này để cấu hình tìm kiếm chỉ trong tài liệu hiện tại. Sau khi nhấp vào OK, đoạn văn bản khớp đầu tiên tìm thấy sẽ được tô sáng trong tài liệu.
  • Find in Files - sử dụng các tùy chọn trên thẻ này để cấu hình tìm kiếm trong tất cả tài liệu dạng văn bản thuộc dự án đang hoạt động, tất cả tài liệu dạng văn bản đang mở hoặc tất cả tài liệu dạng văn bản trong một thư mục được chỉ định. Sau khi nhấp vào OK, tất cả các đoạn văn bản khớp tìm thấy trong các tệp thuộc phạm vi tìm kiếm sẽ được liệt kê thành các mục trong bảng Messages. Mỗi thông báo sẽ thể hiện tệp nguồn, dòng chứa văn bản tìm thấy, toàn bộ văn bản trên dòng đó và vị trí ký tự nơi chuỗi văn bản cần tìm bắt đầu trên dòng.
  • Mỗi thông báo trong bảng Messages có dạng (x, y): <LineText>, trong đó x là vị trí ký tự trên dòng y của tài liệu.
  • Không cần mở các tệp để tìm kiếm văn bản bằng chế độ Find in Files.
  • Khi sử dụng chế độ Find in Files, bạn có thể chuyển đến văn bản tìm thấy từ mục tương ứng trong bảng Messages bằng tính năng dò chéo — chỉ cần nhấp đúp vào thông báo.

Để tìm lần xuất hiện tiếp theo của văn bản trong lần tìm kiếm gần nhất được chỉ định bằng hộp thoại Find Text, hãy sử dụng lệnh Edit » Find Next từ các menu chính (phím tắt: F3). Sau khi chạy lệnh, lần xuất hiện tiếp theo của văn bản được chỉ định trong trường Text to find của hộp thoại Find Text sẽ được tìm và tô sáng. Sử dụng lệnh nhiều lần để lần lượt chuyển qua tất cả các lần xuất hiện khác. Tính năng này áp dụng tất cả các tùy chọn tiêu chí tìm kiếm đã được chỉ định khi thực hiện tìm kiếm văn bản ban đầu.

Bật tùy chọn Find selected text on Find Next trên trang Text Editors - General của hộp thoại Preferences để dùng lệnh này tìm nhanh các lần xuất hiện tiếp theo của văn bản hiện được chọn, thay vì văn bản đã dùng trong thao tác tìm kiếm ban đầu.

Bạn cũng có thể tìm lần xuất hiện tiếp theo của văn bản hiện được chọn trong tài liệu đang hoạt động bằng lệnh Edit » Find Next Selected từ các menu chính (phím tắt: Ctrl+Shift+F). Sau khi chạy lệnh, lần xuất hiện tiếp theo của văn bản được chọn sẽ được chọn. Sử dụng lệnh nhiều lần để lần lượt chuyển qua tất cả các lần xuất hiện khác. Về cơ bản, tính năng này thực hiện tìm kiếm văn bản bằng hộp thoại Find Text, trong đó văn bản được chọn được dùng làm giá trị cho trường Text to find. Tất cả các tùy chọn tiêu chí tìm kiếm được chỉ định gần nhất khi tìm kiếm văn bản bằng hộp thoại Find Text sẽ được áp dụng khi sử dụng tính năng này.

Hộp thoại Replace Text được dùng để cấu hình tìm kiếm và thay thế văn bản cụ thể trong tài liệu hiện tại, tất cả tài liệu dạng văn bản trong dự án đang hoạt động, tất cả tài liệu dạng văn bản đang mở hoặc tất cả tài liệu dạng văn bản trong một thư mục được chỉ định. Bạn có thể truy cập hộp thoại này từ Trình soạn thảo văn bản (hoặc bất kỳ biến thể nào có hỗ trợ nhận diện mã của Trình soạn thảo văn bản) bằng cách chọn lệnh Edit » Replace từ các menu chính (phím tắt: Ctrl+H).

Hộp thoại Replace Text 
Hộp thoại Replace Text

Về cơ bản, hộp thoại hoạt động ở hai chế độ, với các chức năng được cung cấp qua hai tab:

  • Replace Text - sử dụng các tùy chọn trên tab này để cấu hình việc thay thế văn bản chỉ trong tài liệu hiện tại. Để chỉ thay thế lần xuất hiện đầu tiên của văn bản khớp, nhấp vào OK. Nếu tùy chọn Prompt on replace được bật, văn bản sẽ được tô sáng và một hộp thoại sẽ xuất hiện để xác nhận việc thay thế. Nhấp vào Yes để chỉ thay thế lần xuất hiện này. Bạn cũng có thể thay thế tất cả các lần xuất hiện khớp từ hộp thoại này. Hoặc, để thay thế tất cả ngay từ đầu, nhấp vào Replace All, thay vì OK. Tương tự, tất cả các lần xuất hiện khớp với văn bản tìm kiếm sẽ được thay thế trực tiếp hoặc thông qua lời nhắc xác nhận cho từng lần, tùy thuộc vào trạng thái của tùy chọn Prompt on replace.
  • Replace in Files - sử dụng các tùy chọn trên tab này để cấu hình việc thay thế văn bản trên tất cả các tài liệu dạng văn bản trong dự án đang hoạt động, tất cả các tài liệu dạng văn bản đang mở hoặc tất cả các tài liệu dạng văn bản trong một thư mục được chỉ định. Sau khi nhấp vào OK, tất cả các lần xuất hiện của văn bản khớp được tìm thấy trong các tệp thuộc phạm vi tìm kiếm sẽ được thay thế. Tương tự, bạn có thể chọn nhận lời nhắc xác nhận khi thay thế bằng cách thiết lập trước tùy chọn Prompt on replace. Hộp thoại Replacing sẽ xuất hiện để hiển thị tiến trình thay thế. Mỗi lần thay thế sẽ được liệt kê thành một mục trong bảng Messages. Mỗi thông báo sẽ cho biết tệp nguồn, dòng tìm thấy văn bản cần tìm, toàn bộ văn bản trên dòng đó và vị trí ký tự bắt đầu của chuỗi văn bản cần tìm trong dòng.

Trong mỗi trường hợp, một hộp thoại thông tin sẽ xuất hiện, tóm tắt số lần thay thế đã thực hiện.

  • Mỗi thông báo trong bảng Messages có dạng (x, y): <OriginalLineText>, trong đó x là vị trí ký tự trên dòng y của tài liệu. Văn bản hiển thị là văn bản gốc, trước khi được thay thế.
  • Không cần mở tệp để thay thế văn bản bằng chế độ Replace in Files. Bạn có thể chọn mở các tệp này sau khi thay thế bằng cách bật tùy chọn Open changed files in editor trước khi thực hiện thay thế.
  • Khi sử dụng chế độ Replace in Files, bạn có thể định vị chéo đến văn bản đã được thay thế từ mục tương ứng trong bảng Messages - chỉ cần nhấp đúp vào thông báo.

Đối với cả việc tìm kiếm và thay thế văn bản, hãy xem các tùy chọn liên quan trong vùng Find, trên trang Text Editors - General của hộp thoại Preferences.

Chuyển đến một dòng cụ thể

Để chuyển đến một dòng cụ thể trong tài liệu hiện tại, chọn Edit » Goto Line Number từ các menu chính. Sau khi chạy lệnh, hộp thoại Go to Line Number sẽ xuất hiện.

Hộp thoại Go to Line Number
Hộp thoại Go to Line Number

Ban đầu, hộp thoại sẽ hiển thị dòng mà con trỏ văn bản đang nằm tại đó. Nhập số dòng mà bạn muốn chuyển con trỏ đến vào trường New Line Number. Nếu số dòng lớn hơn số dòng có trong tài liệu, hộp thoại sẽ xuất hiện lại để bạn nhập số dòng hợp lệ. Sau khi nhấp vào OK, con trỏ sẽ chuyển đến cùng vị trí trên dòng được chỉ định.

Việc bật hiển thị số dòng có thể rất hữu ích. Bạn có thể thực hiện việc này bằng tùy chọn Show line numbers (và các tùy chọn con liên quan) trên trang Trình soạn thảo văn bản - Hiển thị của hộp thoại Preferences.

Mở tài liệu tại vị trí con trỏ

Bạn có thể tự động mở tài liệu được chỉ ra tại vị trí con trỏ ngay từ trình soạn thảo văn bản. Đặt con trỏ văn bản trong đoạn văn bản mô tả tài liệu cần mở, nhấp chuột phải rồi chọn Open Document Under Cursor từ menu ngữ cảnh (phím tắt: Ctrl+Enter). Tài liệu sẽ được mở và trở thành tài liệu đang hoạt động.

Ví dụ: để mở tài liệu có tên Example_Schematic.SchDoc, trước tiên hãy đảm bảo rằng văn bản Example_Schematic.SchDoc đã được nhập ở đâu đó trong tài liệu văn bản hiện tại. Sau đó đặt con trỏ văn bản tại vị trí bất kỳ trong chuỗi này rồi chạy lệnh - Example_Schematic.SchDoc sẽ được mở và trở thành tài liệu đang hoạt động.

  • Tính năng này không phân biệt chữ hoa, chữ thường, vì vậy kiểu chữ hoa, chữ thường của văn bản nhập trong tài liệu văn bản không cần giống hệt tên tệp thực tế cần mở.
  • Tính năng này chỉ mở được các tài liệu có tên tệp không chứa dấu cách. Ví dụ: cả Example_Design_File.SchDoc và ExampleDesignFile.SchDoc đều có thể mở bằng tính năng này, nhưng Example Design File.SchDoc thì không.
  • Tính năng này chỉ mở các tài liệu được lưu ở cùng vị trí trên ổ cứng với tài liệu văn bản gọi lệnh. Nếu tài liệu không nằm trong thư mục đó, hộp thoại Open sẽ xuất hiện để bạn duyệt tìm và mở tài liệu cần thiết.
  • Nếu tài liệu đã được mở khi gọi lệnh, tài liệu đó sẽ trở thành tài liệu đang hoạt động.

Ngắt dòng tự động

Nếu tài liệu có các dòng văn bản dài, bạn có thể giúp tài liệu dễ đọc hơn bằng cách chèn dấu xuống dòng thủ công hoặc bật chế độ ngắt dòng tự động. Để quản lý chế độ ngắt dòng tự động, hãy dùng các lệnh trong menu chính Tools » Word Wrap:

  • None – tắt chế độ ngắt dòng tự động trong tài liệu hiện tại. Sau khi chạy lệnh, văn bản được nhập sẽ không còn tự động ngắt dòng tại lề phải hay mép phải của cửa sổ vùng hiển thị.
  • At Margin (hoặc nút trên thanh công cụ Text Utilities) – các dòng văn bản trong tài liệu hiện tại sẽ tự động ngắt tại lề. Sau khi chạy lệnh, văn bản được nhập sẽ tự động ngắt dòng tại lề phải, theo giá trị được nhập trong trường Margin width trên trang Trình soạn thảo văn bản - Hiển thị của hộp thoại Preferences.
  • At Window (hoặc nút trên thanh công cụ Text Utilities) – các dòng văn bản trong tài liệu hiện tại sẽ tự động ngắt tại mép cửa sổ hiển thị. Sau khi chạy lệnh, văn bản được nhập sẽ tự động ngắt dòng tại mép phải của cửa sổ vùng hiển thị.
  • Bạn có thể chuyển đổi giữa các chế độ ngắt dòng tự động bất cứ lúc nào – văn bản trong tài liệu sẽ được định dạng lại theo chế độ đã chọn.
  • Bạn cũng có thể cấu hình chế độ ngắt dòng tự động bằng tùy chọn Word wrap (và các tùy chọn con liên quan) trên trang Trình soạn thảo văn bản - Hiển thị của hộp thoại Preferences.

Chia vùng hiển thị tài liệu

Bạn có thể “chia” vùng hiển thị của tài liệu hiện tại thành hai phần riêng biệt theo chiều ngang hoặc chiều dọc, cho phép bạn xem và chỉnh sửa hai khu vực khác nhau của cùng một tài liệu. Để chia cửa sổ tài liệu thành hai phần bằng nhau, hãy chọn một trong các lệnh sau:

  • Window » Split Horizontally – nửa trên sẽ hiển thị một vùng bắt đầu từ đầu (phía trên cùng) của tài liệu. Nửa dưới sẽ hiển thị một vùng bắt đầu từ vị trí trong tài liệu vốn nằm ở trên cùng của cửa sổ hiển thị trước khi thực thi lệnh.
  • Window » Split Vertically – nửa bên trái sẽ hiển thị một vùng bắt đầu từ đầu (phía trên cùng) của tài liệu, với thanh cuộn ngang ở vị trí ngoài cùng bên trái. Nửa bên phải sẽ hiển thị một vùng bắt đầu từ vị trí trong tài liệu vốn nằm ở trên cùng của cửa sổ hiển thị trước khi thực thi lệnh.

Giờ đây, bạn có thể tự do duyệt và chỉnh sửa các vùng khác nhau trong cùng một tài liệu hiện tại.

Một “thanh phân chia” chia cửa sổ thành hai phần. Nhấp và kéo thanh phân chia này để thay đổi vùng tài liệu hiển thị trong mỗi phần.

Để đưa tài liệu trở về chế độ một cửa sổ, hãy sử dụng lệnh Remove Split từ menu Window . Khi bỏ chia cửa sổ, vùng tài liệu được hiển thị sẽ là vùng hiện đang hiển thị ở phần dưới (nếu chia theo chiều ngang) hoặc phần bên phải (nếu chia theo chiều dọc).

Nếu muốn chuyển chế độ chia từ ngang sang dọc hoặc từ dọc sang ngang, hãy sử dụng lệnh Split Vertically hoặc Split Horizontally tương ứng, cũng có trong menu Window .
Các phím tắt được gán cho những thao tác chỉnh sửa văn bản và viết tập lệnh thường dùng – xem Phím tắt của trình soạn thảo tài liệu dạng văn bản.
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