Opsyonal na version label na pinananatili para sa compatibility; ang mga input value ng MacroPanel ay nire-restore mula sa Storage at sine-save sa Storage ayon sa variable name, hindi ayon sa version.
Opsyonal · Ayon lang sa pangalan
Default:""
Ibinabalik na halaga
MacroPanel
Pagkilos / epekto
Bumuo at magpakita ng runtime input panel para sa mga parameter ng macro na kinokontrol ng script.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Panel subtitle/helper text. Writable after construction.
Default:""
versionString
Opsyonal na version label na pinananatili para sa compatibility; ang mga input value ng MacroPanel ay nire-restore mula sa Storage at sine-save sa Storage ayon sa variable name, hindi ayon sa version. Puwedeng baguhin pagkatapos gawin.
Default:""
confirm_textString
Confirm button label.
Default:"Run"
cancel_textString
Cancel button label.
Default:"Cancel"
Mga method
10 method
MacroPanel.notify
Static Method
Magpakita ng dialog ng impormasyon sa pag-block sa overlay runtime at magpatuloy pagkatapos makumpirma ng user.
Syntax
MacroPanel.notify(text)
Mga parameter
Pangalan
Paglalarawan
textAny
Message text or structured value to display.
Kailangan · Ayon sa posisyon o pangalan
Walang default
Ibinabalik na halaga
None — Walang return value pagkatapos ng kumpirmasyon ng user.
Pagkilos / epekto
Magpakita ng dialog ng impormasyon sa pag-block sa overlay runtime at magpatuloy pagkatapos makumpirma ng user. Ang mga string ay mananatiling hindi nagbabago; ginagamit ng mga structured value ang parehong nababasang formatter gaya ng str(value), kabilang ang multi-line expansion para sa nested content.
Pagpapatakbo
Naghihintay matapos: Oo
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Naghihintay sa kumpirmasyon ng user gamit ang shared runtime prompt lock. Nakasunod ang mga sabayang prompt.
Halimbawa
# Hintayin ang pagkumpirma ng user sa mensaheng ito
MacroPanel.notify("Macro is ready")
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
Ihinto ang pagsasagawa ng script sa pamamagitan ng paghahagis ng runtime error.
Syntax
MacroPanel.error(text)
Mga parameter
Pangalan
Paglalarawan
textAny
Error text or structured value to display.
Kailangan · Ayon sa posisyon o pangalan
Walang default
Ibinabalik na halaga
None — Hindi bumabalik; nagtataas ng runtime error.
Pagkilos / epekto
Ihinto ang pagsasagawa ng script sa pamamagitan ng paghahagis ng runtime error. Sa panahon ng macro run, ang overlay ay nagpapakita ng isang karaniwang error sa script na may path ng daloy/pagkilos; ginagamit ng mga structured value ang parehong nababasang formatter gaya ng str(value).
Pagpapatakbo
Naghihintay matapos: Hindi
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: Hindi
Nagbibigay ng fatal script error; hihinto ang lahat ng branch sa Run. Hindi ito prompt para sa kumpirmasyon.
Halimbawa
# Kapag hindi natupad ang precondition, matatapos ang buong Run
if not TfliteModel.exists("enemy_detector"):
MacroPanel.error("Import enemy_detector in Template Manager")
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
Use "text" for normal text or "number" for numeric input. The result value remains a String.
Opsyonal · Ayon sa posisyon o pangalan
Default:"text"
Ibinabalik na halaga
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng nae-edit na field ng text. Gumamit ng desc para sa maliit na text ng helper sa ilalim ng field, at input_type="number" upang ipakita ang numeric na input habang ang ibinalik na halaga ay nananatiling isang String.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.edit_text("player", label="Player", default="Guest")
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng checkbox input.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.checkbox("sound", label="Sound", checked=True)
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng input ng toggle switch.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.toggle_switch("enabled", label="Enabled", checked=True)
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
Default option label or 0-based option index; None selects the first option.
Opsyonal · Ayon sa posisyon o pangalan
Default:None
dropdownBoolean
Render this selector as a dropdown instead of radio options.
Opsyonal · Ayon sa posisyon o pangalan
Default:False
Ibinabalik na halaga
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng tagapili ng radio-group, o i-render ito bilang dropdown kapag dropdown=True.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.radio_group("mode", ["slow", "fast"], label="Mode", default="slow")
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng numeric slider.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.slider("speed", min=1, max=10, step=1, default=5)
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng numeric stepper na may +/- na mga kontrol.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.stepper("count", min=1, max=20, step=1, default=3)
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
MacroPanel — Ang parehong panel para sa matatas na chaining.
Pagkilos / epekto
Magdagdag ng HTML text block. Ang mga pangunahing tag ay nagre-render ng inline, at naka-istilong CSS na mga fragment gaya ng mga card, may kulay na mga seksyon, mga flex row, gradient, at mga rounded box na nagre-render sa isang naka-lock na WebView na hindi pinagana ang JavaScript at external navigation.
Pagpapatakbo
Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Panatilihin sa sariling flow ang panel builder. Ang interactive show() at notify() ay dumadaan sa runtime prompt lock at naghihintay sa user. Tinatapos ng error() ang execution nang may error at naaapektuhan ang buong Run.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.text("<b>Ready</b>")
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
Ipakita ang panel at ibalik ang input value ng user ayon sa tamang type.
Syntax
panel.show()
Mga parameter
Wala
Ibinabalik na halaga
dict — dict ng variableName -> na-type na halaga.
Pagkilos / epekto
Ipakita ang panel at ibalik ang input value ng user ayon sa tamang type. Ang mga value sa Storage na may kaparehong variable name ay magiging default ng field, at ang mga nakumpirmang value ay ise-save pabalik sa Storage ayon sa variable name: Boolean ang checkbox/toggle, Number ang slider, Int ang stepper, 0-based Int option index ang radio/dropdown, at String ang edit text para sa normal na text (o ang katumbas na numeric o naka-save na type). Kapag ang parehong panel.show() call ay paulit-ulit na bumubukas nang walang ibang runtime action, ihihinto ng runtime ang script para maiwasan ang walang katapusang panel loop.
Pagpapatakbo
Naghihintay matapos: Oo
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon
Naghihintay sa kumpirmasyon ng user gamit ang shared runtime prompt lock. Nakasunod ang mga sabayang prompt.
Halimbawa
# Gumawa ng panel at hintayin ang kumpirmasyon ng user
panel = MacroPanel("Settings")
panel.checkbox("enabled", checked=True)
result = panel.show()
print(result)
Mga error / limitasyon
Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.
