Zum Hauptinhalt springen

UI-Element oder aktuelle Seite scrollen (ui_element.scroll)

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

Deklaration​

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

Parameter​

  • Selektor_oder_Element Optionaler Parameter, Tabellenwert; kann ein Selektor, ein von einer Abfrage zurückgegebenes Element oder eine Koordinatentabelle { x = X-Koordinate, y = Y-Koordinate } sein.
  • Richtung Textwert; unterstützt werden "down", "up", "left", "right", "top" und "bottom".
  • Optionen Optionaler Parameter, Tabellenwert; mit point, x und y kann der Trefferpunkt und mit steps 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​

Ohne Selektor wird standardmäßig versucht, die aktuelle Seite zu scrollen. Mit einem Selektor wird versucht, den scrollbaren Bereich des Zielelements zu scrollen. Wenn mehrere Seiten zuverlässig gescrollt werden müssen, sollte die Funktion in einem Lua-Skript wiederholt aufgerufen und die Seitenänderung selbst geprüft werden.

Beispiel​

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

ui_element.scroll({
    text_contains = "列表",
}, "up")