Zum Hauptinhalt springen

UI-Element anklicken (ui_element.click)

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

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.click(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; 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​

Dient zum Anklicken von Schaltflächen, Listeneinträgen, Tastaturtasten oder anderen anklickbaren UI-Elementen. Die Koordinaten einer Koordinatentabelle sind physische Pixel. Für Klicks auf festen Koordinaten sollte vorzugsweise touch.tap verwendet werden. Wenn mehrere Ziele passen und kein eindeutiges Ziel bestimmt werden kann, wird möglicherweise nil, "ambiguous target" zurückgegeben.

Beispiel​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
title = "继续",
role = "button",
})

if not ok then
sys.toast(info_or_err)
end

Hinweis: Der obige Code verwendet die Funktion sys.toast aus einem anderen Kapitel.