! Eine globale Hardwaretastatur verbinden (key.connect_global_keyboard)

Diese Funktion ist erst in Versionen nach 20260805 verfügbar.

Deklaration

Hardwaretastatur-Objekt, Fehlermeldung = key.connect_global_keyboard([Konfigurationseigenschaften])

Parameter

• Konfigurationseigenschaften
  Tabelle, optionaler Parameter; verwendet dieselben Standardeigenschaften und Einschränkungen wie key.connect_keyboard.

Rückgabewerte

• Hardwaretastatur-Objekt
  Hardwaretastatur-Objekt, bei erfolgreicher Verbindung zurückgegeben; bei Fehler nil.
• Fehlermeldung
  Text; bei fehlgeschlagener Verbindung wird die Fehlermeldung zurückgegeben.

Bei einer fehlgeschlagenen Verbindung lauten beide Rückgabewerte zusammen nil, error.

Hinweise

Erstellt und verbindet eine globale Hardwaretastatur. Während des Wartens auf die Verbindung wird die Ausführung implizit abgegeben; vor der Rückgabe der Funktion können andere Threads ausgeführt werden.

• Nach der Verbindung werden normale Tasten und Ziffernblocktasten der bestehenden Schnittstellen key.press, key.down, key.up, key.send_text sowie key(...):press/down/up über dieses Objekt eingegeben.
• Medientasten und herstellerspezifische Tasten behalten ihr bisheriges Verhalten.
• Ohne globale Hardwaretastatur bleibt das Verhalten der bestehenden Schnittstellen unverändert.
• key.down und das entsprechende key.up bleiben gepaart. Auch wenn sich der Verbindungsstatus zwischen den Aufrufen ändert, kommt es weder zu doppelter Eingabe noch zu einer fehlerhaften Freigabe.
• Gleichzeitig kann nur eine globale Hardwaretastatur verbunden sein. Ein erneuter Aufruf während einer noch nicht abgeschlossenen Verbindung oder bei bereits verbundener globaler Hardwaretastatur schlägt fehl.

Beispiel

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())