Aller au contenu principal

Obtenir la liste des éléments textuels (ui_element.list_text_elements)

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

Déclaration​

elements, message_erreur = ui_element.list_text_elements([ pid_ou_options ])

Paramètres​

  • 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​

  • elements type table, tableau des éléments d’interface textuels obtenus. En cas d’échec, nil est renvoyé.
  • message_erreur type texte, cause de l’échec.

Description​

Obtient la liste des éléments textuels de l’application cible actuelle. Les coordonnées des éléments renvoyés sont exprimées en pixels physiques. Cette interface est conservée pour assurer la compatibilité avec les anciens scripts et utilise par défaut une stratégie de requête plus conservatrice ; pour localiser des éléments dans un nouveau script, envisagez en priorité find ou snapshot.

Exemple​

local ui_element = require("ui_element")

local list, err = ui_element.list_text_elements({
    max_level = 1,
    include_hit_state = true,
})

if list then
    for _, item in ipairs(list) do
        if item.text then
            nLog(item.text)
        end
    end
else
    sys.toast(err)
end

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