Wert eines Steuerelements erhöhen (ui_element.increase)

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

Deklaration

Status, Information_oder_Fehlermeldung = ui_element.increase(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 Erhöhung 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.increase({
    role = "slider",
    index = 1,
})