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, use find, 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.