Zum Hauptinhalt springen

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.