Ein UI-Element suchen (ui_element.find)

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

Deklaration

Element, Fehlermeldung = ui_element.find(Selektor [, Optionen ])

Parameter

• Selektor Tabellenwert; beschreibt das zu suchende UI-Element. Siehe Beschreibung der Selektorfelder.
• Optionen Optionaler Parameter, Tabellenwert; siehe Beschreibung der allgemeinen Optionen.

Rückgabewert

• Element Tabellenwert; erstes passendes UI-Element. Bei einem Fehler nil.
• Fehlermeldung Textwert; Fehlerursache. Wenn kein Element gefunden wird, normalerweise "target not found".

Beschreibung

Enthält der Selektor index, wird das index-te passende Element zurückgegeben. Es wird empfohlen, title oder text_contains zusammen mit role zu verwenden, um Mehrdeutigkeiten gleichnamiger Elemente zu verringern.

Beispiel

local ui_element = require("ui_element")

local item, err = ui_element.find({
    title = "搜索",
    role = "text_field",
})

if item then
    ui_element.click(item)
else
    sys.toast(err)
end

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