Zum Hauptinhalt springen

Auswahlstatus festlegen (ui_element.set_checked)

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

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.set_checked(Selektor_oder_Element, Auswahlstatus [, 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.
  • Auswahlstatus
    Boolescher Wert; true legt den Status als aktiviert oder ausgewählt fest, false als deaktiviert oder nicht ausgewählt.
  • 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​

Wenn das Ziel bereits den angegebenen Status hat, gibt die Schnittstelle direkt Erfolg zurück. Das Zielelement muss einen zuverlässigen Bestätigungsstatus bereitstellen können.

Beispiel​

local ui_element = require("ui_element")

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