MacroPanel

Class

Buat dan tampilkan panel input runtime untuk parameter makro yang dikontrol skrip.

Sintaks

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

Parameter konstruktor

Nama	Deskripsi
`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 yang dipertahankan untuk kompatibilitas; nilai input MacroPanel dipulihkan dari Storage dan disimpan ke Storage berdasarkan nama variabel, bukan berdasarkan version. Opsional · Hanya nama Default: `""`

Nilai yang dikembalikan

MacroPanel

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

Nama	Deskripsi
`titleString`	Panel title. Writable after construction. Default: `""`
`subtitleString`	Panel subtitle/helper text. Writable after construction. Default: `""`
`versionString`	Label version opsional yang dipertahankan untuk kompatibilitas; nilai input MacroPanel dipulihkan dari Storage dan disimpan ke Storage berdasarkan nama variabel, bukan berdasarkan version. Dapat ditulis ulang setelah dibuat. Default: `""`
`confirm_textString`	Confirm button label. Default: `"Run"`
`cancel_textString`	Cancel button label. Default: `"Cancel"`

Metode

10 metode

MacroPanel.notify

Static Method

Tampilkan dialog info pemblokiran di runtime overlay dan lanjutkan setelah pengguna mengonfirmasi. String tetap tidak berubah; nilai terstruktur menggunakan formatter yang dapat dibaca seperti str(value), termasuk perluasan multi-baris untuk konten bertingkat.

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

Hentikan eksekusi skrip dengan menimbulkan kesalahan runtime. Selama makro berjalan, hamparan memperlihatkan satu kesalahan skrip standar dengan jalur aliran/tindakan; nilai terstruktur menggunakan formatter yang dapat dibaca sama seperti str(nilai).

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 bidang teks yang dapat diedit. Gunakan desc untuk teks pembantu kecil di bawah bidang, dan input_type="number" untuk menampilkan input numerik sementara nilai yang dikembalikan tetap berupa String.

Sintaks

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

Parameter

Nama	Deskripsi
`nameString`	Variable name to return in panel result. Wajib · Posisi atau nama Tanpa nilai bawaan
`labelString?`	Display label. Leave empty to hide label. Opsional · Posisi atau nama Default: `None`
`defaultString`	Default text value. Opsional · Posisi atau nama Default: `""`
`descString?`	Small helper text displayed below this field. Opsional · Posisi atau nama Default: `None`
`input_typeString`	Use "text" for normal text or "number" for numeric input. The result value remains a String. Opsional · Posisi atau nama Default: `"text"`

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

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 masukan kotak centang.

Sintaks

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

Parameter

Nama	Deskripsi
`nameString`	Variable name. Wajib · Posisi atau nama Tanpa nilai bawaan
`labelString?`	Display label. Leave empty to hide label. Opsional · Posisi atau nama Default: `None`
`checkedBoolean`	Default checked state. Opsional · Posisi atau nama Default: `False`

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

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 masukan sakelar sakelar.

Sintaks

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

Parameter

Nama	Deskripsi
`nameString`	Variable name. Wajib · Posisi atau nama Tanpa nilai bawaan
`labelString?`	Display label. Leave empty to hide label. Opsional · Posisi atau nama Default: `None`
`checkedBoolean`	Default toggle state. Opsional · Posisi atau nama Default: `False`

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

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

Tambahkan pemilih grup radio, atau render sebagai dropdown ketika dropdown=True.

Sintaks

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

Parameter

Nama	Deskripsi
`nameString`	Variable name. Wajib · Posisi atau nama Tanpa nilai bawaan
`optionslist[String]`	Selectable options. Wajib · Posisi atau nama Tanpa nilai bawaan
`labelString?`	Display label. Leave empty to hide label. Opsional · Posisi atau nama Default: `None`
`defaultString\|Int\|None`	Default option label or 0-based option index; None selects the first option. Opsional · Posisi atau nama Default: `None`
`dropdownBoolean`	Render this selector as a dropdown instead of radio options. Opsional · Posisi atau nama Default: `False`

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

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

Method

Tambahkan penggeser numerik.

Sintaks

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

Parameter

Nama	Deskripsi
`nameString`	Variable name. Wajib · Posisi atau nama Tanpa nilai bawaan
`minNumber`	Minimum value. Opsional · Posisi atau nama Default: `0`
`maxNumber`	Maximum value. Opsional · Posisi atau nama Default: `100`
`stepNumber`	Step size between values. Opsional · Posisi atau nama Default: `1`
`labelString?`	Display label. Leave empty to hide label. Opsional · Posisi atau nama Default: `None`
`defaultNumber?`	Default value, clamped to min/max. Opsional · Posisi atau nama Default: `min`

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

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

Method

Tambahkan stepper numerik dengan kontrol +/-.

Sintaks

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

Parameter

Nama	Deskripsi
`nameString`	Variable name. Wajib · Posisi atau nama Tanpa nilai bawaan
`minNumber`	Minimum integer value. Opsional · Posisi atau nama Default: `0`
`maxNumber`	Maximum integer value. Opsional · Posisi atau nama Default: `100`
`stepNumber`	Step size. Opsional · Posisi atau nama Default: `1`
`labelString?`	Display label. Leave empty to hide label. Opsional · Posisi atau nama Default: `None`
`defaultNumber?`	Default value, clamped to min/max. Opsional · Posisi atau nama Default: `min`

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

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.

Sintaks

panel.text(html)

Parameter

Nama	Deskripsi
`htmlString`	HTML content to display. Wajib · Posisi atau nama Tanpa nilai bawaan

Nilai yang dikembalikan

MacroPanel — Panel yang sama untuk rangkaian yang lancar.

Contoh

# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.text("<b>Ready</b>")
result = panel.show()
print(result)

MacroPanel.show

Method

Tampilkan panel dan kembalikan nilai input pengguna sesuai tipe. Nilai Storage yang memiliki nama variabel yang sama menjadi nilai default field, dan nilai yang dikonfirmasi disimpan kembali ke Storage berdasarkan nama variabel: nilai checkbox/toggle adalah Boolean, nilai slider adalah Number, nilai stepper adalah Int, nilai radio/dropdown adalah indeks opsi Int berbasis 0, dan nilai edit text adalah String untuk teks normal (atau tipe numerik/tersimpan yang sesuai). Jika panggilan panel.show() yang sama terbuka berulang tanpa tindakan runtime lain, runtime akan menghentikan skrip untuk menghindari loop panel tanpa akhir.

Sintaks

panel.show()

Nilai yang dikembalikan

dict — dict dari VariableName -> nilai yang diketik.

Contoh

# Buat panel dan tunggu konfirmasi pengguna
panel = MacroPanel("Settings")
panel.checkbox("enabled", checked=True)
result = panel.show()
print(result)