Localizar vários elementos de UI (ui_element.find_all)
Esta função está disponível somente a partir da versão 20260507.
Declaração
elementos = ui_element.find_all(seletor [, opcoes])
Parâmetros
- seletor Tabela que descreve os elementos de UI a localizar; consulte Descrição dos campos do seletor.
- opcoes Tabela opcional; consulte Descrição das opções comuns.
Valor retornado
- elementos Tabela; array formado por todos os elementos correspondentes. Retorna um array vazio quando não há correspondências.
Descrição
find_allé adequado para enumerar controles do mesmo tipo ou verificar primeiro a quantidade de correspondências. Se você precisar somente da primeira correspondência, usefind, que é mais direto.
Exemplo
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
Observação: o código acima usa a função nLog, que não pertence a este capítulo.