MacroPanel

Tạo bảng để người dùng nhập thiết lập cho macro. Thêm các ô nhập rồi gọi show() để hiển thị bảng.

Cú pháp

MacroPanel(title="", subtitle="", confirm_text="Run", cancel_text="Cancel", *, version="")

Tham số khởi tạo

TênMô tả
titleString
Tiêu đề panel.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: ""
subtitleString
Phụ đề hoặc mô tả ngắn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: ""
confirm_textString
Nhãn nút xác nhận.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: "Run"
cancel_textString
Nhãn nút hủy.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: "Cancel"
versionString
Nhãn version tùy chọn được giữ để tương thích; không đặt lại thiết lập đã lưu native và không đổi định danh của chúng.
Tùy chọn · Chỉ truyền theo tên
Mặc định: ""

Giá trị trả về

Ví dụ

panel = MacroPanel("Run config", "Pick options before run", confirm_text="Start", cancel_text="Back")
panel.text("<b>Ready?</b>")
panel.checkbox("safe_mode", "Safe mode", checked=True)
panel.toggle_switch("retry", "Auto retry", checked=False)
panel.edit_text("username", default="player01", desc="Shown below the field")
panel.edit_text("runs", "Runs", default=3, desc="Numbers only", input_type="number")
panel.radio_group("mode", ["farm", "pvp"], default="farm")
panel.radio_group("target", ["boss", "minion"], default="boss", dropdown=True)
panel.slider("speed", min=0, max=100, step=5, default=60)
panel.stepper("retry_count", min=0, max=10, step=1, default=2)
values = panel.show()

Thuộc tính

TênMô tả
titleString
Tiêu đề panel. Có thể gán lại sau khi khởi tạo.
Mặc định: ""
subtitleString
Phụ đề hoặc mô tả ngắn. Có thể gán lại sau khi khởi tạo.
Mặc định: ""
versionString
Nhãn version tùy chọn được giữ để tương thích; không đặt lại thiết lập đã lưu native và không đổi định danh của chúng. Có thể gán lại sau khi khởi tạo.
Mặc định: ""
confirm_textString
Nhãn nút xác nhận.
Mặc định: "Run"
cancel_textString
Nhãn nút hủy.
Mặc định: "Cancel"

Phương thức

13 phương thức

MacroPanel.notify

Hiện thông báo và chờ người dùng xác nhận rồi mới chạy tiếp script. Chuỗi hiển thị nguyên văn; giá trị khác hiển thị như str(value), với dữ liệu lồng nhau được chia thành nhiều dòng.

Cú pháp

MacroPanel.notify(text)

Tham số

TênMô tả
textAny
Chuỗi thông báo hoặc giá trị có cấu trúc cần hiển thị.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

None — Không có giá trị trả về sau khi người dùng xác nhận.

Ví dụ

# Chờ người dùng xác nhận đã đọc thông báo này
MacroPanel.notify("Macro is ready")

MacroPanel.error

Báo lỗi bằng thông báo này và dừng script. Khi chạy macro, màn hình lỗi cho biết luồng chạy và đường dẫn action. Giá trị khác được đổi thành văn bản dễ đọc như str(value).

Cú pháp

MacroPanel.error(text)

Tham số

TênMô tả
textAny
Chuỗi lỗi hoặc giá trị có cấu trúc cần hiển thị.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

None — Không trả về; ném lỗi runtime.

Ví dụ

# Điều kiện tiên quyết không đạt sẽ kết thúc toàn bộ lượt Run
if not TfliteModel.exists("enemy_detector"):
    MacroPanel.error("Import enemy_detector in Template Manager")

MacroPanel.edit_text

Thêm ô nhập có thể chỉnh sửa. Ô số nhận số thập phân hữu hạn có dấu, ký pháp khoa học và khoảng trắng bao quanh; không nhận chuỗi rỗng, NaN, Infinity, số tràn hoặc số hệ 16. Dữ liệu không hợp lệ hiện lỗi và chặn Run trong hộp thoại; trên bảng nổi, bản nháp lỗi giữ giá trị hợp lệ cuối cùng và không được lưu.

Cú pháp

panel.edit_text(name, label=None, default="", desc=None, input_type="text")

Tham số

TênMô tả
nameString
Khóa ô không rỗng trong dict trả về và thiết lập bền vững. Mỗi ô trong một bảng phải có khóa khác nhau. Thiết lập native dùng phạm vi macro cùng namespace được bảo vệ (hoặc macroId cục bộ), biến thể và tên ô; title, version, nhãn bản địa hóa và instance runtime không nằm trong khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
labelString?
Nhãn hiển thị. Để trống nếu muốn ẩn nhãn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
defaultString|Number
Giá trị đầu vào chỉ dùng khi không có giá trị native đã lưu hoặc giá trị Storage tương ứng. Ô số trên bảng nổi cần giá trị ban đầu hợp lệ từ thiết lập native, Storage hoặc default; nếu không show() sẽ báo lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: ""
descString?
Mô tả nhỏ hiển thị bên dưới ô nhập này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
input_typeString
Dùng "text" để nhận String hoặc "number" để nhận Number (float). Giá trị native đã lưu được ưu tiên; nếu không, chuỗi số đã lưu trước đây trong Storage vẫn được khôi phục.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: "text"

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.edit_text("player", label="Player", default="Guest")
result = panel.show()
print(result)

MacroPanel.checkbox

Thêm ô để người dùng đánh dấu hoặc bỏ đánh dấu.

Cú pháp

panel.checkbox(name, label=None, checked=False)

Tham số

TênMô tả
nameString
Khóa ô không rỗng trong dict trả về và thiết lập bền vững. Mỗi ô trong một bảng phải có khóa khác nhau. Thiết lập native dùng phạm vi macro cùng namespace được bảo vệ (hoặc macroId cục bộ), biến thể và tên ô; title, version, nhãn bản địa hóa và instance runtime không nằm trong khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
labelString?
Nhãn hiển thị. Để trống nếu muốn ẩn nhãn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
checkedBoolean
Giá trị ban đầu chỉ dùng khi không có giá trị native đã lưu hoặc giá trị Storage tương ứng.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.checkbox("sound", label="Sound", checked=True)
result = panel.show()
print(result)

MacroPanel.toggle_switch

Thêm công tắc để người dùng bật hoặc tắt.

Cú pháp

panel.toggle_switch(name, label=None, checked=False)

Tham số

TênMô tả
nameString
Khóa ô không rỗng trong dict trả về và thiết lập bền vững. Mỗi ô trong một bảng phải có khóa khác nhau. Thiết lập native dùng phạm vi macro cùng namespace được bảo vệ (hoặc macroId cục bộ), biến thể và tên ô; title, version, nhãn bản địa hóa và instance runtime không nằm trong khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
labelString?
Nhãn hiển thị. Để trống nếu muốn ẩn nhãn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
checkedBoolean
Giá trị ban đầu chỉ dùng khi không có giá trị native đã lưu hoặc giá trị Storage tương ứng.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.toggle_switch("enabled", label="Enabled", checked=True)
result = panel.show()
print(result)

MacroPanel.radio_group

Thêm bộ chọn radio-group, hoặc hiển thị dạng dropdown chọn đơn / chọn nhiều khi dropdown=True. Options có thể là list hoặc dict ánh xạ nhãn lựa chọn cha sang danh sách lựa chọn con khi thiết lập depends_on.

Cú pháp

panel.radio_group(name, options, label=None, default=None, dropdown=False, multi_select=False, depends_on=None)

Tham số

TênMô tả
nameString
Khóa ô không rỗng trong dict trả về và thiết lập bền vững. Mỗi ô trong một bảng phải có khóa khác nhau. Thiết lập native dùng phạm vi macro cùng namespace được bảo vệ (hoặc macroId cục bộ), biến thể và tên ô; title, version, nhãn bản địa hóa và instance runtime không nằm trong khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
optionslist[String]|dict[String, list[String]]
Danh sách lựa chọn hoặc dict ánh xạ từ nhãn của ô cha sang danh sách lựa chọn con khi có depends_on.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
labelString?
Nhãn hiển thị. Để trống nếu muốn ẩn nhãn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
defaultString|Int|list|None
Lựa chọn ban đầu chỉ dùng khi không có giá trị native đã lưu hoặc giá trị Storage tương ứng: nhãn, chỉ số 0-based hoặc danh sách nhãn/chỉ số khi multi_select=True; None chọn lựa chọn đầu tiên (hoặc không chọn mục nào khi multi_select=True).
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
dropdownBoolean
Hiển thị bộ chọn này dạng dropdown thay vì các lựa chọn radio.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False
multi_selectBoolean
Cho phép chọn nhiều mục khi hiển thị dạng dropdown. Bảng trả về danh sách chỉ số 0-based của các mục được chọn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False
depends_onString?
Tên biến của bộ chọn cha đứng trước mà dropdown này phụ thuộc vào để hiển thị danh sách động.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.radio_group("mode", ["slow", "fast"], label="Mode", default="slow")
result = panel.show()
print(result)

MacroPanel.slider

Thêm thanh trượt số.

Cú pháp

panel.slider(name, min=0, max=100, step=1, label=None, default=None)

Tham số

TênMô tả
nameString
Khóa ô không rỗng trong dict trả về và thiết lập bền vững. Mỗi ô trong một bảng phải có khóa khác nhau. Thiết lập native dùng phạm vi macro cùng namespace được bảo vệ (hoặc macroId cục bộ), biến thể và tên ô; title, version, nhãn bản địa hóa và instance runtime không nằm trong khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
minNumber
Giá trị nhỏ nhất.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
maxNumber
Giá trị lớn nhất; phải lớn hơn hoặc bằng min.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 100
stepNumber
Bước tăng dương giữa các giá trị trên thanh trượt.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 1
labelString?
Nhãn hiển thị. Để trống nếu muốn ẩn nhãn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
defaultNumber?
Giá trị ban đầu chỉ dùng khi không có giá trị native đã lưu hoặc giá trị Storage tương ứng, sau đó được giới hạn theo min/max.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: min

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.slider("speed", min=1, max=10, step=1, default=5)
result = panel.show()
print(result)

MacroPanel.stepper

Thêm bộ tăng/giảm số với nút +/-.

Cú pháp

panel.stepper(name, min=0, max=100, step=1, label=None, default=None)

Tham số

TênMô tả
nameString
Khóa ô không rỗng trong dict trả về và thiết lập bền vững. Mỗi ô trong một bảng phải có khóa khác nhau. Thiết lập native dùng phạm vi macro cùng namespace được bảo vệ (hoặc macroId cục bộ), biến thể và tên ô; title, version, nhãn bản địa hóa và instance runtime không nằm trong khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
minNumber
Giá trị nguyên nhỏ nhất.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
maxNumber
Giá trị nguyên lớn nhất; phải lớn hơn hoặc bằng min.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 100
stepNumber
Bước tăng nguyên dương cho mỗi lần nhấn + hoặc -. Tham số số được chuyển thành số nguyên.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 1
labelString?
Nhãn hiển thị. Để trống nếu muốn ẩn nhãn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
defaultNumber?
Giá trị ban đầu chỉ dùng khi không có giá trị native đã lưu hoặc giá trị Storage tương ứng, sau đó được giới hạn theo min/max.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: min

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.stepper("count", min=1, max=20, step=1, default=3)
result = panel.show()
print(result)

MacroPanel.text

Thêm khối text HTML. Các thẻ cơ bản hiển thị inline, còn đoạn có CSS như thẻ hướng dẫn, vùng màu, hàng flex, gradient và bo góc sẽ hiển thị bằng WebView đã khóa JavaScript và chặn điều hướng ra ngoài.

Cú pháp

panel.text(html)

Tham số

TênMô tả
htmlString
Nội dung HTML cần hiển thị.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Tạo bảng điều khiển và chờ người dùng xác nhận
panel = MacroPanel("Settings")
panel.text("<b>Ready</b>")
result = panel.show()
print(result)

MacroPanel.localize

Đăng ký bản sao bảng đã dịch cho bảng nổi. Khi đổi bộ chọn, nội dung đổi ngay cả lúc macro tạm dừng, không cần callback Python hay mở lại bảng; giá trị, bản nháp và vị trí cửa sổ được giữ nguyên. Chỉ được thay đổi văn bản: tiêu đề, phụ đề, nhãn và mô tả ô nhập, HTML và chữ hiển thị của lựa chọn. Các lựa chọn tương ứng theo vị trí; giá trị, Storage và mặc định vẫn theo bảng gốc. Lựa chọn của bộ chọn ngôn ngữ phải giống hệt nhau. Các bản phải có cùng số lượng, thứ tự, loại và tên thành phần, giới hạn số, input_type, multi_select, cấu trúc phụ thuộc và số lựa chọn, kể cả khóa và thứ tự các nhánh phụ thuộc. Không hỗ trợ bản địa hóa lồng nhau. Gọi lại sẽ thay các bản sao; thay đổi bảng nguồn sau đó chỉ có hiệu lực khi đăng ký lại. Hệ thống kiểm tra khi gọi và khi show(); thay đổi không tương thích sẽ báo lỗi. Bảng đã bản địa hóa không thể hiển thị ở chế độ dialog.

Cú pháp

panel.localize(selector, variants, *, locales=None)

Tham số

TênMô tả
selectorString
Tên của radio_group hoặc dropdown chọn một mục đã thêm trước đó; bộ chọn này không được dùng multi_select hoặc depends_on.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
variantsdict[String, MacroPanel]
Mỗi nhãn lựa chọn của bộ chọn phải có đúng một bảng tương ứng, dùng chính nhãn đó làm khóa. Các bảng được sao chép khi gọi; mặc định của chúng không thay đổi hành vi của bảng gốc.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
localesdict[String, String]?
Bản đồ tùy chọn từ nhãn lựa chọn sang mã ngôn ngữ ứng dụng en, vi, th, id hoặc fil. Phải bao phủ chính xác mọi biến thể và điều khiển nhãn dựng sẵn như tóm tắt Tạm dừng và chọn tất cả; None giữ ngôn ngữ của ứng dụng.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None

Giá trị trả về

MacroPanel — Chính bảng này, để có thể gọi tiếp phương thức khác của bảng trên kết quả trả về.

Ví dụ

# Chuyển bảng nổi giữa tiếng Anh và tiếng Việt
en = MacroPanel("Fishing")
en.radio_group("language", ["English", "Tiếng Việt"], label="Language")
en.checkbox("enabled", label="Enabled", checked=True)
vi = MacroPanel("Câu cá")
vi.radio_group("language", ["English", "Tiếng Việt"], label="Ngôn ngữ")
vi.checkbox("enabled", label="Bật", checked=True)
en.localize("language", {"English": en, "Tiếng Việt": vi}, locales={"English": "en", "Tiếng Việt": "vi"})
config = en.show(mode="floating")

MacroPanel.show

Hiển thị bảng và trả về dict gồm tên ô nhập và giá trị. Giá trị native đã lưu được ưu tiên, sau đó đến mục Storage cùng tên rồi default của từng ô. Mỗi thay đổi hợp lệ lưu thiết lập native ngay và đồng bộ Storage, kể cả khi macro đang tạm dừng; script không cần gọi Storage.set(), values() hoặc close(). Ô đánh dấu và công tắc trả Boolean, thanh trượt và ô số trả Number, bộ tăng/giảm trả Int, bộ chọn trả chỉ số Int bắt đầu từ 0, còn ô văn bản trả String. Mở lại cùng lệnh show() liên tục mà không có thao tác runtime khác sẽ dừng script để tránh vòng lặp mở bảng vô tận.

Cú pháp

panel.show(*, mode="dialog", anchor="top_left", stop_button=True, width=None, height=None, collapsed=None, dock_position=None, pause_on_expand=True)

Tham số

TênMô tả
modeString
dialog chờ xác nhận; nút Hủy trả về dict rỗng. floating trả về ngay và giữ bảng đến khi đóng hoặc kết thúc lượt chạy macro. Mở bảng nổi khác sẽ thay thế bảng đang hiển thị.
Tùy chọn · Chỉ truyền theo tên
Mặc định: "dialog"
anchorString
Vị trí bảng nổi mở rộng: top_left, top_right, bottom_left, bottom_right hoặc free. free bắt đầu ở góc trên trái và cho phép kéo bảng mở rộng độc lập với dock dùng chung. Kéo dock dùng chung chỉ di chuyển dock. Gọi lại show() giữ vị trí hiện tại.
Tùy chọn · Chỉ truyền theo tên
Mặc định: "top_left"
stop_buttonBoolean
Hiện nút Dừng trên bảng nổi mở rộng. Bảng thu nhỏ không có nút Dừng riêng; dock chính vẫn có nút Dừng thông thường ở chế độ row.
Tùy chọn · Chỉ truyền theo tên
Mặc định: True
widthInt?
Độ rộng cửa sổ nổi đang mở, tính bằng pixel trên màn hình hiện tại; None dùng kích thước gọn tự động. Nhận số nguyên dương. Overlay giới hạn kích thước để đủ phần đầu và vừa vùng màn hình khả dụng; panel thu nhỏ luôn gọn. Không áp dụng scale tọa độ của Point.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
heightInt?
Độ cao cửa sổ nổi đang mở, tính bằng pixel trên màn hình hiện tại; None tự điều chỉnh theo nội dung. Nhận số nguyên dương. Overlay giới hạn kích thước để đủ phần đầu và vừa vùng màn hình phía trên bàn phím; panel thu nhỏ luôn gọn. Không áp dụng scale tọa độ của Point.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
collapsedBoolean?
Chỉ dùng với mode floating; giá trị khác None bị từ chối trong mode dialog. True thu nhỏ bảng thành nút mở trên dock chính; False mở rộng bảng. None mở rộng bảng mới và giữ trạng thái hiện tại khi gọi lại show(). Có hiệu lực ngay lần hiển thị đầu tiên. Truyền lại anchor, width hoặc height tùy chỉnh trong các lần gọi show() sau để giữ bố cục mở rộng.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
dock_positionPoint | tuple[Number, Number] | list[Number] | None
Chỉ dùng với mode floating; giá trị khác None bị từ chối trong mode dialog. Đặt góc trên trái của dock chính dùng chung bằng pixel trên màn hình hiện tại, kể cả khi bảng đang mở rộng hoặc trước lần thu nhỏ đầu tiên. Dock di chuyển với hiệu ứng 160 ms. Nhận Point(x, y) hoặc tuple/list gồm đúng hai số hữu hạn trong khoảng -2147483648 đến 2147483647; không áp dụng scale và neo của Point. Dock được giới hạn trong màn hình sau khi đo kích thước thực tế. None giữ vị trí hiện tại. Bảng mở rộng giữ vị trí riêng với mọi anchor, kể cả free.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
pause_on_expandBoolean
Chỉ dùng với mode floating; truyền rõ tham số này trong mode dialog sẽ báo lỗi. True tạm dừng macro khi bảng nổi đang mở rộng và hiển thị. show() trả về ngay; thực thi tạm dừng tại điểm kiểm tra runtime kế tiếp cho đến khi thu nhỏ, ẩn hoặc đóng bảng. Dùng collapsed=True hoặc pause_on_expand=False để script tiếp tục khi bảng đang mở. False tắt tạm dừng do bảng này; trạng thái tạm dừng thủ công vẫn được giữ. Mỗi lần show() dùng giá trị của lần gọi đó; nếu bỏ qua thì trở lại mặc định True.
Tùy chọn · Chỉ truyền theo tên
Mặc định: True

Giá trị trả về

dict — dialog trả về dict riêng. floating trả về cùng một dict khi gọi show() lại; thay đổi hợp lệ của người dùng cập nhật dict ngay và đã được lưu native, đồng bộ vào Storage. Biến gán riêng, như speed = config["speed"], giữ giá trị đã đọc lúc gán. values() trả về bản sao riêng; close() giữ các giá trị cuối. Sửa dict trả về bằng Python không đổi bảng hoặc thiết lập đã lưu; lần cập nhật tiếp theo từ bảng sẽ thay thế các chỉnh sửa đó.

Ví dụ

# Bắt đầu thu nhỏ, sau đó mở rộng, thu nhỏ và di chuyển dock
panel = MacroPanel("Run config")
panel.show(mode="floating", collapsed=True, dock_position=Point(20, 100))
wait(1000)
panel.show(mode="floating", collapsed=False, pause_on_expand=False)
wait(1000)
panel.show(mode="floating", collapsed=True, dock_position=(100, 200))

MacroPanel.values

Sao chép các giá trị hợp lệ cuối cùng sau show(). Thay đổi trên bảng về sau không đổi bản sao này. Thay đổi hợp lệ trên bảng nổi đã được lưu native và đồng bộ vào Storage ngay; sau close(), values() trả về các giá trị cuối. Gọi trước show() sẽ báo lỗi.

Cú pháp

panel.values()

Giá trị trả về

dict — dict riêng gồm tên ô nhập và giá trị.

Ví dụ

# Đọc cấu hình trực tiếp từ cửa sổ thu gọn ở mỗi lượt lặp
panel = MacroPanel("Live controls")
panel.slider("speed", min=1, max=10, default=5)
config = panel.show(mode="floating", anchor="free", stop_button=True, width=320, height=240)
for index in range(10):
    print(config["speed"])
    wait(1000)
snapshot = panel.values()
panel.close()

MacroPanel.close

Đóng bảng nổi này. Các giá trị đã chấp nhận đã được lưu native và đồng bộ vào Storage, kể cả khi macro đang tạm dừng. Thao tác này không dừng macro. Có thể gọi lại sau show(); values() vẫn trả về các giá trị cuối. Gọi trước show() sẽ báo lỗi.

Cú pháp

panel.close()

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Đọc cấu hình trực tiếp từ cửa sổ thu gọn ở mỗi lượt lặp
panel = MacroPanel("Live controls")
panel.slider("speed", min=1, max=10, default=5)
config = panel.show(mode="floating", anchor="free", stop_button=True, width=320, height=240)
for index in range(10):
    print(config["speed"])
    wait(1000)
snapshot = panel.values()
panel.close()