Zum Hauptinhalt springen

Wert eines Steuerelements festlegen (ui_element.set_value)

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

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.set_value(Selektor_oder_Element, Wert [, 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.
  • Wert
    Textwert, Ganzzahl, reelle Zahl oder boolescher Wert; festzulegender Wert des Steuerelements.
  • 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​

Diese Schnittstelle eignet sich für Steuerelemente, die das direkte Festlegen eines Werts unterstützen. Bei Schiebereglern kann eine reelle Zahl von 0.0 ~ 1.0 oder ein Prozenttext wie "50%" versucht werden. Wenn sich das Zielelement tatsächlich nicht ändert, wird möglicherweise nil, "value unchanged" zurückgegeben.

Beispiel​

local ui_element = require("ui_element")

ui_element.set_value({
    role = "slider",
    index = 1,
}, 0.5)