Aller au contenu principal

Obtenir un snapshot de l’interface (ui_element.snapshot)

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

Déclaration​

snapshot, message_erreur = ui_element.snapshot([ options ])

Paramètres​

Valeur renvoyée​

  • snapshot type table contenant la liste actuelle des éléments d’interface et les méthodes du snapshot. En cas d’échec, nil est renvoyé.
  • message_erreur type texte, cause de l’échec.

Méthodes du snapshot​

element = snapshot:find(selecteur)
elements = snapshot:find_all(selecteur)
etat, info = snapshot:click(selecteur_ou_element [, options ])
etat, info = snapshot:scroll([ selecteur_ou_element, ] direction [, options ])
etat, info = snapshot:input_text(selecteur_ou_element, texte [, options ])
etat, info = snapshot:set_text(selecteur_ou_element, texte [, options ])
etat, info = snapshot:clear_text(selecteur_ou_element [, options ])
etat, info = snapshot:toggle(selecteur_ou_element [, options ])
etat, info = snapshot:set_checked(selecteur_ou_element, etat_cocher [, options ])
etat, info = snapshot:set_value(selecteur_ou_element, valeur [, options ])
etat, info = snapshot:increase(selecteur_ou_element [, options ])
etat, info = snapshot:decrease(selecteur_ou_element [, options ])

Description​

Un snapshot est un résultat ponctuel, adapté à plusieurs recherches ou actions successives dans la même interface. Après un changement de page, une fenêtre contextuelle, un défilement ou un rafraîchissement du contenu, rappelez snapshot(). Les champs courants d’une table de snapshot comprennent elements et count.

Exemple​

local ui_element = require("ui_element")

local ui, err = ui_element.snapshot({
    max_level = 2,
})

if ui then
    local search = ui:find({
        title = "搜索",
        role = "text_field",
    })
    if search then
        ui:set_text(search, "XXTouch")
    end
else
    sys.toast(err)
end

Remarque : le code utilise la fonction sys.toast, qui n’appartient pas à ce chapitre.