Aller au contenu principal

Ajouter du texte (ui_element.input_text)

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

Déclaration​

etat, info_ou_erreur = ui_element.input_text(selecteur_ou_element, texte [, options ])

Paramètres​

  • selecteur_ou_element type table, peut être un sélecteur, un élément renvoyé par une requête ou une table de coordonnées { x = coord_x, y = coord_y }.
  • texte type texte, contenu à ajouter.
  • options paramètre facultatif de type table ; consultez la description des options générales.

Valeur renvoyée​

  • etat type booléen, vaut true en cas de réussite et nil en cas d’échec.
  • info_ou_erreur type table contenant les informations de l’action en cas de réussite, ou texte décrivant la cause de l’échec.

Description​

Cette interface localise d’abord la cible de saisie textuelle, puis y ajoute le texte. Pour remplacer le texte existant, utilisez set_text.

Exemple​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.input_text({
    title = "搜索",
    role = "text_field",
}, "XXTouch")

if not ok then
    sys.toast(info_or_err)
end

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