Obter a lista de elementos de texto (ui_element.list_text_elements)

Esta função está disponível somente a partir da versão 20260507.

Declaração

elementos, mensagem_de_erro = ui_element.list_text_elements([ numero_do_processo_ou_opcoes ])

Parâmetros

• numero_do_processo_ou_opcoes Parâmetro opcional, inteiro ou tabela. O inteiro representa o número do processo do aplicativo de destino; para a tabela, consulte Descrição das opções comuns.

Valores retornados

• elementos Tabela; array de elementos de UI. nil em caso de falha.
• mensagem_de_erro Texto; motivo da falha.

Descrição

Obtém a lista de elementos de texto do aplicativo de destino atual. Os campos de coordenadas nos elementos retornados são expressos em pixels físicos. Esta interface é mantida para compatibilidade com scripts antigos e usa uma estratégia de consulta mais conservadora por padrão; em scripts novos, prefira find ou snapshot para localizar elementos.

Exemplo

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

Observação: o código acima usa as funções nLog e sys.toast, que não pertencem a este capítulo.