Descrição das opções comuns

Este módulo está disponível somente a partir da versão 20260507.

Várias interfaces de ui_element aceitam uma tabela de opções para especificar o aplicativo de destino, a quantidade retornada, a profundidade de recursão, a verificação de acerto e o passo da rolagem.

Opções de consulta

local options = {
    pid = app.front_pid(),
    max_level = 2,
    max_elements = 200,
    include_hit_state = true,
}

• pid Inteiro; especifica o identificador do processo do aplicativo de destino. Quando omitido, normalmente usa o aplicativo em primeiro plano.
• max_level Inteiro; profundidade de recursão dos elementos filhos. Use normalmente 1 ou 2 para controlar a quantidade de dados retornada.
• max_elements Inteiro; quantidade máxima de elementos do nível superior retornados.
• fallback_children Booleano; tenta ler os elementos filhos quando a lista comum está vazia. O padrão varia conforme a interface.
• include_hit_state Booleano; indica se os campos do estado de acerto devem ser incluídos.
• hit_test Booleano; indica se o acerto por amostragem da tela deve ser habilitado. Scripts comuns normalmente não precisam ativá-lo.
• fallback_hit_test Booleano; indica se deve tentar o acerto por amostragem da tela quando a lista comum está vazia.
• hit_test_spacing Número; espaçamento da amostragem da tela, em coordenadas lógicas. O padrão é 40.

Opções de ação

• point Tabela; especifica o ponto de coordenadas usado para rolagem ou acerto, por exemplo { x = 200, y = 700 }, em pixels físicos.
• x / y Inteiro; equivalente a point, pode ser colocado diretamente na tabela de opções.
• steps Número; parâmetro de passo para operações de rolagem, aumento ou redução. O efeito exato depende do controle de destino.

Descrição

list_text_elements() é mais conservador por padrão para compatibilidade com scripts antigos. find(), find_all(), snapshot() e as interfaces de ação são mais adequados para uso direto em scripts novos. hit_test pode retornar elementos mais próximos da interface atual do nível superior, mas tem custo maior; recomenda-se usá-lo somente quando uma consulta comum não encontrar o elemento.