UI-Element an einer Koordinate abrufen (ui_element.text_element_at_position)

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

Deklaration

Element, Fehlermeldung = ui_element.text_element_at_position(X-Koordinate, Y-Koordinate [, Prozessnummer_oder_Optionen ])

Parameter

• X-Koordinate, Y-Koordinate
  Ganzzahl; Bildschirmkoordinaten in physischen Pixeln.
• Prozessnummer_oder_Optionen
  Optionaler Parameter, Ganzzahl oder Tabellenwert. Eine Ganzzahl bezeichnet die Prozessnummer der Ziel-App; ein Tabellenwert wird unter Beschreibung der allgemeinen Optionen erläutert.

Rückgabewert

• Element
  Tabellenwert; an der Koordinate getroffenes UI-Element. Bei einem Fehler nil.
• Fehlermeldung
  Textwert; Fehlerursache.

Beschreibung

Diese Schnittstelle eignet sich, wenn der Koordinatenpunkt bereits bekannt ist, um das UI-Element dort nachträglich zu ermitteln, beispielsweise um nahegelegene Steuerelemente anhand von Bilderkennung oder OCR zu verstehen. Sie ist keine Schnittstelle zum Klicken auf Koordinaten. Für Klicks auf festen Koordinaten sollte touch.tap verwendet werden. Wenn die Koordinate leer ist oder die Zieloberfläche kein lesbares Element bereitstellt, kann die Abfrage fehlschlagen.

Beispiel

local ui_element = require("ui_element")

local item, err = ui_element.text_element_at_position(300, 500, {
    include_hit_state = true,
    max_level = 1,
})

if item then
    nLog(item.text or item.value or "")
else
    sys.toast(err)
end

Hinweis: Der obige Code verwendet die Funktionen nLog und sys.toast aus anderen Kapiteln.