Zum Hauptinhalt springen

Status eines Steuerelements umschalten (ui_element.toggle)

Diese Funktion ist erst in Versionen nach 20260507 verfügbar.

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.toggle(Selektor_oder_Element [, Optionen ])

Parameter​

  • Selektor_oder_Element Tabellenwert; kann ein Selektor, ein von einer Abfrage zurückgegebenes Element oder eine Koordinatentabelle { x = X-Koordinate, y = Y-Koordinate } sein.
  • Optionen Optionaler Parameter, Tabellenwert; siehe Beschreibung der allgemeinen Optionen.

Rückgabewert​

  • Status Boolescher Wert; bei Erfolg true, bei einem Fehler nil.
  • Information_oder_Fehlermeldung Bei Erfolg Aktionsinformationen als Tabellenwert, bei einem Fehler die Fehlerursache als Textwert.

Beschreibung​

Dient zum Umschalten von Schaltern, Kontrollkästchen oder anderen Steuerelementen, deren Bestätigungsstatus gelesen werden kann. Wenn der Zielstatus nicht gelesen werden kann, wird möglicherweise nil, "state unavailable" zurückgegeben.

Beispiel​

local ui_element = require("ui_element")

ui_element.toggle({
    title = "飞行模式",
    role = "switch",
})