Pular para o conteúdo principal

Obter o elemento de UI em uma coordenada (ui_element.text_element_at_position)

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

Declaração​

elemento, mensagem_de_erro = ui_element.text_element_at_position(coordenada_x, coordenada_y [, numero_do_processo_ou_opcoes])

Parâmetros​

  • coordenada_x, coordenada_y Inteiros; coordenadas da tela, em pixels físicos.
  • 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​

  • elemento Tabela; elemento de UI atingido na coordenada. nil em caso de falha.
  • mensagem_de_erro Texto; motivo da falha.

Descrição​

Esta interface é adequada para localizar um elemento de UI quando o ponto de coordenadas já é conhecido, por exemplo, para entender controles próximos a partir de reconhecimento de imagem ou resultados de OCR. Ela não é uma interface para clicar em coordenadas; para clicar em coordenadas fixas, use touch.tap. Pode falhar quando a coordenada estiver vazia ou a interface de destino não fornecer um elemento legível.

Exemplo​

local ui_element = require("ui_element")

local item, err = ui_element.text_element_at_position(300, 500, {
    include_hit_state = true,
    max_level = 1,
})

if item then
    nLog(item.text or item.value or "")
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.