Mehrere UI-Elemente suchen (ui_element.find_all)

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

Deklaration

Elementliste = ui_element.find_all(Selektor [, Optionen ])

Parameter

• Selektor Tabellenwert; beschreibt die zu suchenden UI-Elemente. Siehe Beschreibung der Selektorfelder.
• Optionen Optionaler Parameter, Tabellenwert; siehe Beschreibung der allgemeinen Optionen.

Rückgabewert

• Elementliste Tabellenwert; Array aller passenden Elemente. Bei keinen Treffern ein leeres Array.

Beschreibung

find_all eignet sich zum Aufzählen gleichartiger Steuerelemente oder zum vorherigen Prüfen der Trefferanzahl. Wenn nur das erste passende Element benötigt wird, ist find direkter.

Beispiel

local ui_element = require("ui_element")

local items = ui_element.find_all({
    role = "button",
})

for i, item in ipairs(items) do
    nLog(i, item.text or "")
end

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