Saisir du texte (key.input_text)

Cette fonction est disponible dans les versions postérieures à 20260816

Déclaration

Succès, message d’erreur = key.input_text(texte [, appuyer sur Entrée à la fin de la saisie ])

Paramètres

• Texte Type texte, texte UTF-8 à saisir, qui peut être vide ; "\b" effectue une opération de retour arrière.
• Appuyer sur Entrée à la fin de la saisie Type booléen, indique s’il faut appuyer sur la touche Entrée du clavier après la saisie ; false par défaut.

Valeur de retour

• Succès Type booléen, renvoie true lorsque l’opération de saisie simulée a été envoyée avec succès et false en cas d’échec.
• Message d’erreur Type texte, cause de l’échec.

Description

Saisit du texte dans le champ d’entrée ayant déjà le focus dans le programme au premier plan, en simulant la sélection de caractères par le clavier virtuel.

Cette fonction ne lit ni ne modifie le presse-papiers public du système.

Cette fonction ne peut pas saisir de texte dans un champ de mot de passe ; utilisez sys.input_text pour les champs de mot de passe.

Un retour true indique uniquement que l’opération de saisie simulée a été envoyée ; il ne garantit pas que le champ cible a accepté le texte.

Exemple

local ok, err = key.input_text("你好，XXTouch 🙂")
assert(ok, err)
--
local ok, err = key.input_text("hello!\b", true)
assert(ok, err)