Trình dựng hộp thoại

Trình dựng hộp thoại là gì?

Trình dựng hộp thoại (Dialog Builder) là một tính năng hữu ích cho phép bạn tạo các hộp thoại tương tác bên trong macro của mình. Các hộp thoại này thường được sử dụng để thu thập đầu vào từ người dùng trước khi macro bắt đầu thực thi chính. Hãy nghĩ về nó như một cách để tùy chỉnh hành vi macro dựa trên các lựa chọn của người dùng.

Ví dụ, bạn có thể tạo một hộp thoại hỏi, "Bạn muốn chạy tùy chọn nào?" Nếu người dùng chọn tùy chọn 5, macro sau đó sẽ thực hiện một tập hợp các hành động cụ thể được liên kết với lựa chọn đó.

Các thành phần của hộp thoại

Hộp thoại được xây dựng bằng nhiều thành phần giao diện người dùng (UI) khác nhau. Mỗi hộp thoại có thể bao gồm các phần tử sau:

1. CheckBox: Dành cho các lựa chọn có/không hoặc đúng/sai
2. EditText: Dành cho đầu vào văn bản tự do
3. RadioGroup: Một vùng chứa cho nhiều RadioButton
4. Column: Một vùng chứa bố cục theo chiều dọc
5. Row: Một vùng chứa bố cục theo chiều ngang
6. RadioButton: Dành cho các lựa chọn đơn trong một RadioGroup
7. TextView: Dành cho việc hiển thị thông tin văn bản

Giá trị mặc định

Các thành phần đầu vào của hộp thoại hiện có thể định nghĩa các giá trị ban đầu trước khi hộp thoại được hiển thị:

• EditText(id, hint, defaultValue) đặt văn bản bắt đầu
• CheckBox(id, text, defaultChecked) đặt trạng thái kiểm bắt đầu
• RadioGroup(id, defaultButtonId) chọn một nút radio mặc định

Khi một giá trị mặc định được cung cấp, nó sẽ được sử dụng đầu tiên khi hộp thoại mở.

Xây dựng hộp thoại của bạn

Bạn có thể kết hợp các thành phần này để tạo một hộp thoại tùy chỉnh phù hợp với nhu cầu của macro. Trong số các thành phần này, có ba loại đầu vào mà bạn có thể lấy giá trị:

• CheckBox
• EditText
• RadioGroup

Để truy cập các giá trị từ các thành phần đầu vào này, bạn có thể dùng hàm Dialog:getValueById() trong logic macro của mình. Bằng cách chỉ định ID duy nhất của thành phần, bạn có thể lấy đầu vào của người dùng và sử dụng nó để hướng dẫn các hành động của macro.

Lưu ý: Mỗi thành phần trong hộp thoại của bạn phải có một ID duy nhất. Điều này đảm bảo rằng macro có thể xác định chính xác và lấy giá trị từ thành phần cụ thể mà bạn đang nhắm đến. Các ID trùng lặp có thể dẫn đến nhầm lẫn và lỗi trong quá trình thực thi macro.