Aller au contenu principal

! Connecter le clavier matériel global (key.connect_global_keyboard)

Cette fonction est disponible à partir de la version 20260805

Déclaration​

objet clavier matériel, message d’erreur = key.connect_global_keyboard([propriétés de configuration])

Paramètres​

  • propriétés de configuration
    Type table, paramètre facultatif ; utilise les mêmes propriétés par défaut et contraintes que key.connect_keyboard.

Valeur de retour​

  • objet clavier matériel
    Objet clavier matériel, renvoyé en cas de réussite de la connexion ; en cas d’échec, renvoie nil.
  • message d’erreur
    Chaîne, message d’erreur en cas d’échec de la connexion.

En cas d’échec de la connexion, les deux valeurs renvoyées sont nil, error.

Description​

Crée et connecte le clavier matériel global. Pendant l’attente de connexion, le contrôle est implicitement cédé ; avant le retour de la fonction, un autre thread peut avoir l’occasion de s’exécuter.

  • Après la connexion, les touches ordinaires et du pavé numérique des anciennes interfaces key.press, key.down, key.up, key.send_text et key(...):press/down/up sont saisies par cet objet
  • Les touches multimédias et les touches personnalisées du fabricant conservent leur comportement d’origine
  • Sans clavier matériel global, le comportement des interfaces existantes reste inchangé.
  • key.down et le key.up correspondant restent appariés ; même si l’état de la connexion change entre les deux appels, cela ne provoque ni saisie répétée ni relâchement incorrect
  • Un seul clavier matériel global peut être connecté à la fois. Un nouvel appel pendant une connexion inachevée ou lorsqu’un clavier global existe déjà renvoie un échec.

Exemple​

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())