MacroPanel

Buat panel untuk meminta pengaturan makro dari pengguna. Tambahkan kolom, lalu panggil show() untuk menampilkannya.

Sintaks

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

Parameter konstruktor

NamaDeskripsi
titleString
Panel title.
Opsional · Posisi atau nama
Default: ""
subtitleString
Panel subtitle/helper text.
Opsional · Posisi atau nama
Default: ""
confirm_textString
Confirm button label.
Opsional · Posisi atau nama
Default: "Run"
cancel_textString
Cancel button label.
Opsional · Posisi atau nama
Default: "Cancel"
versionString
Label version opsional untuk kompatibilitas; tidak mereset pengaturan native yang tersimpan atau mengubah identitasnya.
Opsional · Hanya nama
Default: ""

Nilai yang dikembalikan

Contoh

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()

Field

NamaDeskripsi
titleString
Panel title. Writable after construction.
Default: ""
subtitleString
Panel subtitle/helper text. Writable after construction.
Default: ""
versionString
Label version opsional untuk kompatibilitas; tidak mereset pengaturan native yang tersimpan atau mengubah identitasnya. Dapat ditulis ulang setelah dibuat.
Default: ""
confirm_textString
Confirm button label.
Default: "Run"
cancel_textString
Cancel button label.
Default: "Cancel"

Metode

13 metode

MacroPanel.notify

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

NamaDeskripsi
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

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

NamaDeskripsi
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

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.

Sintaks

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

Parameter

NamaDeskripsi
nameString
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
labelString?
Display label. Leave empty to hide label.
Opsional · Posisi atau nama
Default: None
defaultString|Number
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.
Opsional · Posisi atau nama
Default: ""
descString?
Small helper text displayed below this field.
Opsional · Posisi atau nama
Default: None
input_typeString
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

Tambahkan kotak yang dapat dicentang atau dikosongkan pengguna.

Sintaks

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

Parameter

NamaDeskripsi
nameString
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
labelString?
Display label. Leave empty to hide label.
Opsional · Posisi atau nama
Default: None
checkedBoolean
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

Tambahkan sakelar yang dapat diaktifkan atau dinonaktifkan pengguna.

Sintaks

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

Parameter

NamaDeskripsi
nameString
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
labelString?
Display label. Leave empty to hide label.
Opsional · Posisi atau nama
Default: None
checkedBoolean
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

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.

Sintaks

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

Parameter

NamaDeskripsi
nameString
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
optionslist[String]|dict[String, list[String]]
Selectable options or dictionary mapping parent option labels to lists of options when depends_on is set.
Wajib · Posisi atau nama
Tanpa nilai bawaan
labelString?
Display label. Leave empty to hide label.
Opsional · Posisi atau nama
Default: None
defaultString|Int|list|None
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.
Opsional · Posisi atau nama
Default: False
depends_onString?
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)

MacroPanel.slider

Tambahkan penggeser numerik.

Sintaks

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

Parameter

NamaDeskripsi
nameString
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 value.
Opsional · Posisi atau nama
Default: 0
maxNumber
Nilai maksimum; harus setidaknya min.
Opsional · Posisi atau nama
Default: 100
stepNumber
Kenaikan positif antar nilai penggeser.
Opsional · Posisi atau nama
Default: 1
labelString?
Display label. Leave empty to hide label.
Opsional · Posisi atau nama
Default: None
defaultNumber?
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)

MacroPanel.stepper

Tambahkan stepper numerik dengan kontrol +/-.

Sintaks

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

Parameter

NamaDeskripsi
nameString
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.
Opsional · Posisi atau nama
Default: 1
labelString?
Display label. Leave empty to hide label.
Opsional · Posisi atau nama
Default: None
defaultNumber?
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

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.

Sintaks

panel.text(html)

Parameter

NamaDeskripsi
htmlString
HTML content to display.
Wajib · Posisi atau nama
Tanpa nilai bawaan

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.text("<b>Ready</b>")
result = panel.show()
print(result)

MacroPanel.localize

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.

Sintaks

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

Parameter

NamaDeskripsi
selectorString
Nama radio_group atau dropdown pilihan tunggal yang sudah ditambahkan sebelumnya; multi_select dan depends_on tidak boleh digunakan pada pemilih ini.
Wajib · Posisi atau nama
Tanpa nilai bawaan
variantsdict[String, MacroPanel]
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.
Wajib · Posisi atau nama
Tanpa nilai bawaan
localesdict[String, String]?
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

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.

Sintaks

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

Parameter

NamaDeskripsi
modeString
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.
Opsional · Hanya nama
Default: "dialog"
anchorString
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.
Opsional · Hanya nama
Default: None
dock_positionPoint | tuple[Number, Number] | list[Number] | None
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

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

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()