Zum Hauptinhalt springen

Liste der Textelemente abrufen (ui_element.list_text_elements)

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

Deklaration​

Elementliste, Fehlermeldung = ui_element.list_text_elements([ Prozessnummer_oder_Optionen ])

Parameter​

  • 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​

  • Elementliste Tabellenwert; Array der UI-Elemente. Bei einem Fehler nil.
  • Fehlermeldung Textwert; Fehlerursache.

Beschreibung​

Ruft die Liste der Textelemente der aktuellen Ziel-App ab. Die Koordinatenfelder der zurückgegebenen Elemente verwenden physische Pixel. Diese Schnittstelle bleibt zur Kompatibilität mit älteren Skripten erhalten und verwendet standardmäßig eine vorsichtigere Abfragestrategie. Für die Elementsuche in neuen Skripten sollten vorzugsweise find oder snapshot verwendet werden.

Beispiel​

local ui_element = require("ui_element")

local list, err = ui_element.list_text_elements({
    max_level = 1,
    include_hit_state = true,
})

if list then
    for _, item in ipairs(list) do
        if item.text then
            nLog(item.text)
        end
    end
else
    sys.toast(err)
end

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