Zum Hauptinhalt springen

Wert eines Steuerelements verringern (ui_element.decrease)

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

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.decrease(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; mit steps kann der Schrittparameter festgelegt werden.

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 für Schieberegler, Auswahlräder und andere Steuerelemente, die eine Erhöhung oder Verringerung unterstützen. Das Maß jeder Verringerung wird vom Zielelement bestimmt. Für eine präzise Steuerung sollte die Funktion in einem Lua-Skript wiederholt aufgerufen und das Ergebnis gelesen werden.

Beispiel​

local ui_element = require("ui_element")

ui_element.decrease({
    role = "picker",
    index = 1,
}, {
    steps = 2,
})