Aller au contenu principal

Obtenir l’élément d’interface aux coordonnées indiquées (ui_element.text_element_at_position)

Cette fonction est disponible à partir des versions postérieures au 20260507

Déclaration​

element, message_erreur = ui_element.text_element_at_position(coord_x, coord_y [, pid_ou_options ])

Paramètres​

  • coord_x, coord_y type entier, coordonnées de l’écran, en pixels physiques.
  • pid_ou_options paramètre facultatif de type entier ou table. Un entier représente le PID de l’application cible ; pour une table, consultez la description des options générales.

Valeur renvoyée​

  • element type table, élément d’interface détecté aux coordonnées indiquées. En cas d’échec, nil est renvoyé.
  • message_erreur type texte, cause de l’échec.

Description​

Cette interface convient à la recherche inverse d’un élément lorsque ses coordonnées sont connues, par exemple pour comprendre le contrôle voisin d’après un résultat de reconnaissance d’image ou d’OCR. Il ne s’agit pas d’une interface de clic par coordonnées ; pour un clic à coordonnées fixes, utilisez touch.tap. L’appel peut échouer si les coordonnées correspondent à une zone vide ou si l’interface cible ne fournit aucun élément lisible.

Exemple​

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

Remarque : le code utilise les fonctions nLog et sys.toast, qui n’appartiennent pas à ce chapitre.