Relâcher une touche du clavier matériel (:up)

Cette méthode est disponible à partir de la version 20260805

Déclaration

succès, message d’erreur = objet clavier matériel:up(code de touche)
succès, message d’erreur = objet clavier matériel:up(Usage_Page, Usage_ID)

Paramètres

• code de touche Chaîne, utilise la même correspondance de noms de touches que key.press.
• Usage Page Entier, cet objet clavier matériel n’accepte que le Keyboard/Keypad Usage Page 0x07.
• Usage ID Entier, numéro de la touche physique, et non son encodage de caractère.

Valeur de retour

• succès Booléen, renvoie true si l’envoi réussit et false dans le cas contraire.
• message d’erreur Chaîne, message d’erreur en cas d’échec de l’envoi.

Description

Relâche une touche du clavier matériel précédemment enfoncée par :down.

Lorsque le même clavier exécute une séquence :press ou :send_text, cette méthode renvoie false, "hardware keyboard is busy". En cas d’échec de l’envoi, ne réessaie pas automatiquement avec un autre mode de saisie.

Exemple

local keyboard = assert(key.connect_keyboard())

assert(keyboard:down("LEFTSHIFT"))
assert(keyboard:up("LEFTSHIFT"))

assert(keyboard:disconnect())