Saltar al contenido principal

Obtener el elemento UI situado en unas coordenadas (ui_element.text_element_at_position)

Esta función solo está disponible a partir de las versiones posteriores a 20260507

Declaración​

elemento, información_de_error = ui_element.text_element_at_position(coordenada_x, coordenada_y [, pid_o_opciones ])

Parámetros​

  • coordenada_x, coordenada_y Tipo entero: coordenadas de pantalla, en píxeles físicos.
  • pid_o_opciones Parámetro opcional, de tipo entero o tabla. El tipo entero indica el PID de la aplicación objetivo; el tipo tabla consulta la descripción de las opciones comunes.

Valor devuelto​

  • elemento Tipo tabla: elemento UI alcanzado en las coordenadas. Es nil cuando falla.
  • información de error Tipo texto: causa del error.

Descripción​

Esta interfaz es adecuada para buscar el elemento UI cercano a un punto cuyas coordenadas ya se conocen, por ejemplo, para interpretar un control cercano a partir de resultados de reconocimiento de imágenes u OCR. No es una interfaz para hacer clic por coordenadas; para hacer clic en coordenadas fijas se debe usar touch.tap. Puede fallar si el punto está vacío o si la interfaz objetivo no proporciona elementos legibles.

Ejemplo​

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

Nota: el código anterior usa las funciones de fuera de este capítulo nLog y sys.toast