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 normalmente1ou2para 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 exclusão de atributos
Disponíveis a partir de 20261115. Apenas para snapshot() e list_text_elements(). Todas são booleanas, têm valor padrão false e também se aplicam aos elementos filhos. Quando esses estados não forem necessários, ativar as opções de exclusão pode reduzir o custo das consultas e acelerar a captura de snapshots.
- exclude_visibility
Quandotrue, pula as consultas de visibilidade e omiteisVisible. - exclude_map
Quandotrue, pula a verificação do atributo de mapa e omiteisMap; os elementos de mapa são mantidos. - exclude_hit_state
Quandotrue, pula as verificações de hit no ponto central e omitecanHit,hitVerified,hitTestPointehitTestPointLogical. Não pode ser combinada cominclude_hit_state = true.
O escopo dos elementos, o texto, as coordenadas e as regras de busca complementar de elementos de hit_test / fallback_hit_test permanecem iguais. Não exclua um campo de estado se precisar filtrar por ele.
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 apoint, 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_testpode 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.