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.