Label version opsional untuk kompatibilitas; tidak mereset pengaturan native yang tersimpan atau mengubah identitasnya. Dapat ditulis ulang setelah dibuat.
Tampilkan pesan dan tunggu konfirmasi pengguna sebelum melanjutkan skrip. String ditampilkan apa adanya; nilai lain ditampilkan seperti str(value), dengan data bersarang pada beberapa baris.
Sintaks
MacroPanel.notify(text)
Parameter
Nama
Deskripsi
textAny
Message text or structured value to display.
Wajib · Posisi atau nama
Tanpa nilai bawaan
Nilai yang dikembalikan
None — Tidak ada nilai pengembalian setelah konfirmasi pengguna.
Contoh
# Tunggu pengguna mengakui pesan ini
MacroPanel.notify("Macro is ready")
MacroPanel.error
Static Method
Laporkan kesalahan dengan pesan ini dan hentikan skrip. Saat makro berjalan, tampilan kesalahan menyertakan alur dan jalur aksi. Nilai lain diubah menjadi teks yang mudah dibaca seperti str(value).
Sintaks
MacroPanel.error(text)
Parameter
Nama
Deskripsi
textAny
Error text or structured value to display.
Wajib · Posisi atau nama
Tanpa nilai bawaan
Nilai yang dikembalikan
None — Tidak kembali; memunculkan kesalahan runtime.
Contoh
# Prasyarat yang gagal mengakhiri seluruh Run
if not TfliteModel.exists("enemy_detector"):
MacroPanel.error("Import enemy_detector in Template Manager")
MacroPanel.edit_text
Method
Tambahkan kolom yang dapat diedit. Input angka menerima desimal bertanda yang terbatas, notasi ilmiah, dan spasi di sekitarnya; nilai kosong, NaN, Infinity, luapan, dan heksadesimal tidak valid. Input dialog yang tidak valid menampilkan kesalahan dan menghalangi Run; draf panel mengambang yang tidak valid menampilkan kesalahan, mempertahankan nilai valid terakhir, dan tidak menyimpan draf.
Kunci kolom tidak kosong dalam dict hasil dan pengaturan persisten. Setiap kolom dalam satu panel harus memiliki kunci berbeda. Pengaturan native memakai cakupan makro dan namespace terlindungi (atau macroId lokal), varian, dan nama kolom; title, version, label terjemahan, dan instance runtime bukan bagian dari kunci.
Nilai input hanya digunakan jika tidak ada nilai native tersimpan atau nilai Storage yang cocok. Kolom angka pada panel mengambang memerlukan nilai awal yang valid dari pengaturan native, Storage, atau default ini; jika tidak, show() menimbulkan kesalahan.
Gunakan "text" untuk String atau "number" untuk Number (float). Nilai native tersimpan diprioritaskan; jika tidak, string angka yang pernah disimpan di Storage dapat dipulihkan.
Opsional · Posisi atau nama
Default:"text"
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.edit_text("player", label="Player", default="Guest")
result = panel.show()
print(result)
MacroPanel.checkbox
Method
Tambahkan kotak yang dapat dicentang atau dikosongkan pengguna.
Kunci kolom tidak kosong dalam dict hasil dan pengaturan persisten. Setiap kolom dalam satu panel harus memiliki kunci berbeda. Pengaturan native memakai cakupan makro dan namespace terlindungi (atau macroId lokal), varian, dan nama kolom; title, version, label terjemahan, dan instance runtime bukan bagian dari kunci.
Nilai awal hanya digunakan jika tidak ada nilai native tersimpan atau nilai Storage yang cocok.
Opsional · Posisi atau nama
Default:False
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.checkbox("sound", label="Sound", checked=True)
result = panel.show()
print(result)
MacroPanel.toggle_switch
Method
Tambahkan sakelar yang dapat diaktifkan atau dinonaktifkan pengguna.
Kunci kolom tidak kosong dalam dict hasil dan pengaturan persisten. Setiap kolom dalam satu panel harus memiliki kunci berbeda. Pengaturan native memakai cakupan makro dan namespace terlindungi (atau macroId lokal), varian, dan nama kolom; title, version, label terjemahan, dan instance runtime bukan bagian dari kunci.
Nilai awal hanya digunakan jika tidak ada nilai native tersimpan atau nilai Storage yang cocok.
Opsional · Posisi atau nama
Default:False
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.toggle_switch("enabled", label="Enabled", checked=True)
result = panel.show()
print(result)
MacroPanel.radio_group
Method
Add a radio-group selector, or render it as a single- or multi-select dropdown when dropdown=True. Options can be a list or a dict mapping parent option labels to sub-option lists when depends_on is set.
Kunci kolom tidak kosong dalam dict hasil dan pengaturan persisten. Setiap kolom dalam satu panel harus memiliki kunci berbeda. Pengaturan native memakai cakupan makro dan namespace terlindungi (atau macroId lokal), varian, dan nama kolom; title, version, label terjemahan, dan instance runtime bukan bagian dari kunci.
Pilihan awal hanya digunakan jika tidak ada nilai native tersimpan atau nilai Storage yang cocok: label, indeks opsi berbasis 0, atau daftar label/indeks saat multi_select=True; None memilih pilihan pertama (atau tidak memilih saat multi_select=True).
Opsional · Posisi atau nama
Default:None
dropdownBoolean
Render this selector as a dropdown instead of radio options.
Opsional · Posisi atau nama
Default:False
multi_selectBoolean
Allow selecting multiple options when rendered as a dropdown. The panel returns a list of 0-based option indices.
Variable name of the preceding parent selector this dropdown depends on for cascading dynamic options.
Opsional · Posisi atau nama
Default:None
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.radio_group("mode", ["slow", "fast"], label="Mode", default="slow")
result = panel.show()
print(result)
Kunci kolom tidak kosong dalam dict hasil dan pengaturan persisten. Setiap kolom dalam satu panel harus memiliki kunci berbeda. Pengaturan native memakai cakupan makro dan namespace terlindungi (atau macroId lokal), varian, dan nama kolom; title, version, label terjemahan, dan instance runtime bukan bagian dari kunci.
Nilai awal hanya digunakan jika tidak ada nilai native tersimpan atau nilai Storage yang cocok, lalu dibatasi ke min/max.
Opsional · Posisi atau nama
Default:min
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.slider("speed", min=1, max=10, step=1, default=5)
result = panel.show()
print(result)
Kunci kolom tidak kosong dalam dict hasil dan pengaturan persisten. Setiap kolom dalam satu panel harus memiliki kunci berbeda. Pengaturan native memakai cakupan makro dan namespace terlindungi (atau macroId lokal), varian, dan nama kolom; title, version, label terjemahan, dan instance runtime bukan bagian dari kunci.
Wajib · Posisi atau nama
Tanpa nilai bawaan
minNumber
Minimum integer value.
Opsional · Posisi atau nama
Default:0
maxNumber
Nilai bilangan bulat maksimum; harus setidaknya min.
Opsional · Posisi atau nama
Default:100
stepNumber
Kenaikan bilangan bulat positif untuk setiap tekanan + atau -. Masukan angka diubah menjadi bilangan bulat.
Nilai awal hanya digunakan jika tidak ada nilai native tersimpan atau nilai Storage yang cocok, lalu dibatasi ke min/max.
Opsional · Posisi atau nama
Default:min
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.stepper("count", min=1, max=20, step=1, default=3)
result = panel.show()
print(result)
MacroPanel.text
Method
Tambahkan blok teks HTML. Tag dasar dirender sebaris, dan fragmen bergaya CSS seperti kartu, bagian berwarna, baris fleksibel, gradien, dan kotak bulat dirender dalam WebView yang terkunci dengan JavaScript dan navigasi eksternal dinonaktifkan.
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.text("<b>Ready</b>")
result = panel.show()
print(result)
MacroPanel.localize
Method
Daftarkan salinan panel terjemahan untuk panel mengambang. Perubahan pemilih langsung memperbarui tampilan, bahkan saat makro dijeda, tanpa callback Python atau membuka ulang panel; nilai, draf, dan posisi jendela tetap terjaga. Hanya teks yang boleh berbeda: judul, subjudul, label dan deskripsi kolom, HTML, serta teks pilihan. Pilihan dicocokkan berdasarkan posisi; nilai, Storage, dan nilai default tetap mengikuti panel dasar. Pilihan pada pemilih bahasa harus identik. Semua varian harus memiliki jumlah, urutan, jenis dan nama widget, batas angka, input_type, multi_select, struktur dependensi, dan jumlah pilihan yang sama, termasuk kunci dan urutan cabang dependensi. Lokalisasi bersarang tidak didukung. Panggilan berikutnya mengganti salinan; perubahan panel sumber tidak berpengaruh sampai didaftarkan ulang. Validasi dilakukan saat pemanggilan dan show(); perubahan yang tidak cocok menimbulkan kesalahan. Panel yang dilokalkan tidak dapat ditampilkan dalam mode dialog.
Tepat satu panel untuk setiap label pilihan pemilih, dengan label tersebut sebagai kunci. Panel disalin saat dipanggil; nilai default varian tidak mengubah perilaku panel dasar.
Optional map from selector option labels to supported app language codes en, vi, th, id, or fil. It must cover every variant exactly and controls built-in panel labels such as Pause and select-all summaries; None keeps the app language.
Opsional · Hanya nama
Default:None
Nilai yang dikembalikan
MacroPanel — Panel yang sama, sehingga metode panel lain dapat dipanggil pada hasilnya.
Contoh
# Ganti bahasa panel mengambang antara Inggris dan Vietnam
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
Method
Tampilkan panel dan kembalikan dict berisi nama kolom dan nilainya. Nilai native tersimpan diprioritaskan, lalu entri Storage yang cocok, lalu nilai awal setiap kolom. Setiap perubahan yang diterima langsung menyimpan pengaturan native dan mencerminkannya ke Storage, termasuk saat makro dijeda; skrip tidak perlu memanggil Storage.set(), values(), atau close(). Kotak centang dan sakelar menghasilkan Boolean, penggeser dan kolom angka Number, stepper Int, pemilih indeks Int mulai 0, dan kolom teks String. Membuka show() yang sama berulang tanpa aksi runtime lain menghentikan skrip agar panel tidak terus terbuka tanpa akhir.
dialog menunggu konfirmasi; Cancel mengembalikan dict kosong. floating langsung mengembalikan hasil dan tetap tampil sampai ditutup atau makro selesai. Panel mengambang lain menggantikan panel yang terlihat.
Posisi panel mengambang yang diperluas: top_left, top_right, bottom_left, bottom_right, atau free. free dimulai di kiri atas dan panel dapat diseret terpisah dari dock bersama. Menyeret dock hanya memindahkan dock. Pemanggilan show() berulang mempertahankan posisi saat ini.
Opsional · Hanya nama
Default:"top_left"
stop_buttonBoolean
Tampilkan tombol Berhenti pada panel mengambang yang diperluas. Panel yang diciutkan tidak memiliki tombol Berhenti terpisah; dock utama tetap memiliki tombol Berhenti biasa dalam mode row.
Opsional · Hanya nama
Default:True
widthInt?
Lebar jendela mengambang saat diperluas dalam piksel layar saat ini; None memakai ukuran ringkas otomatis. Gunakan bilangan bulat positif. Overlay membatasi ukuran agar header dan jendela muat di layar; panel yang diciutkan tetap ringkas. Skala koordinat Point tidak berlaku.
Opsional · Hanya nama
Default:None
heightInt?
Tinggi jendela mengambang saat diperluas dalam piksel layar saat ini; None mengikuti isi. Gunakan bilangan bulat positif. Overlay membatasi ukuran agar header dan jendela muat di area layar di atas keyboard; panel yang diciutkan tetap ringkas. Skala koordinat Point tidak berlaku.
Opsional · Hanya nama
Default:None
collapsedBoolean?
Hanya untuk mode floating; nilai selain None ditolak dalam mode dialog. True menciutkan panel menjadi tombol buka pada dock utama; False memperluasnya. None membuka panel baru dalam keadaan diperluas dan mempertahankan keadaan saat ini pada pemanggilan show() berulang. Berlaku juga saat pertama ditampilkan. Sertakan kembali anchor, width, atau height kustom dalam pemanggilan show() berikutnya untuk mempertahankan tata letak panel yang diperluas.
Hanya untuk mode floating; nilai selain None ditolak dalam mode dialog. Atur posisi kiri atas dock utama bersama dalam piksel layar saat ini, termasuk saat panel diperluas atau sebelum pertama kali diciutkan. Dock bergerak dengan animasi 160 ms. Menerima Point(x, y) atau tuple/list berisi tepat dua angka berhingga dalam rentang -2147483648 hingga 2147483647; skala dan anchor Point tidak berlaku. Dock dibatasi agar tetap di layar setelah ukuran sebenarnya diukur. None mempertahankan posisi saat ini. Posisi panel yang diperluas tetap terpisah untuk semua anchor, termasuk free.
Opsional · Hanya nama
Default:None
pause_on_expandBoolean
Hanya untuk mode floating; memberikan argumen ini secara eksplisit pada mode dialog menimbulkan error. True menjeda makro saat panel mengambang sedang terbuka penuh dan terlihat. show() langsung mengembalikan hasil; eksekusi dijeda pada titik pemeriksaan runtime berikutnya hingga panel diciutkan, disembunyikan, atau ditutup. Gunakan collapsed=True atau pause_on_expand=False agar skrip tetap berjalan saat panel terbuka. False menonaktifkan jeda dari panel ini; jeda manual tetap berlaku. Setiap show() memakai nilai pada panggilan tersebut, kembali ke True jika tidak diberikan.
Opsional · Hanya nama
Default:True
Nilai yang dikembalikan
dict — dialog mengembalikan dict terpisah. floating mengembalikan dict yang sama saat show() dipanggil lagi; perubahan pengguna yang valid langsung memperbarui entrinya serta sudah disimpan secara native dan dicerminkan ke Storage. Variabel terpisah seperti speed = config["speed"] menyimpan nilai saat dibaca. values() mengembalikan salinan terpisah; close() mempertahankan nilai terakhir. Mengedit dict di Python tidak mengubah panel atau pengaturan tersimpan, dan pembaruan panel berikutnya menimpa edit tersebut.
Contoh
# Mulai dalam keadaan diciutkan, lalu perluas, ciutkan, dan pindahkan 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
Method
Salin nilai terakhir yang valid setelah show(). Perubahan panel selanjutnya tidak mengubah salinan ini. Perubahan valid pada panel mengambang sudah disimpan secara native dan langsung dicerminkan ke Storage; setelah close(), values() mengembalikan nilai terakhir. Memanggil sebelum show() menimbulkan kesalahan.
Sintaks
panel.values()
Nilai yang dikembalikan
dict — Dict terpisah berisi nama kolom dan nilainya.
Contoh
# Baca pengaturan terkini dari jendela ringkas pada setiap iterasi
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
Method
Tutup panel mengambang ini. Nilai yang diterima sudah disimpan secara native dan dicerminkan ke Storage, termasuk saat makro dijeda. Makro tidak dihentikan. Aman dipanggil ulang setelah show(); values() tetap mengembalikan nilai terakhir. Memanggil sebelum show() menimbulkan kesalahan.
Sintaks
panel.close()
Nilai yang dikembalikan
None — Tidak ada nilai kembalian.
Contoh
# Baca pengaturan terkini dari jendela ringkas pada setiap iterasi
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()