Die globale Hardwaretastatur trennen (key.disconnect_global_keyboard)

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

Deklaration

Erfolgreich, Fehlermeldung = key.disconnect_global_keyboard()

Rückgabewerte

• Erfolgreich
  Boolescher Wert; bei erfolgreicher Trennung oder wenn keine globale Hardwaretastatur vorhanden ist true, bei Fehler false.
• Fehlermeldung
  Text; bei fehlgeschlagener Trennung wird die Fehlermeldung zurückgegeben.

Hinweise

Gibt alle Tasten frei und trennt die aktuelle globale Hardwaretastatur. Nach der Trennung verhalten sich die bestehenden Tastenschnittstellen wieder wie vor der Verbindung.

• Diese Funktion kann wiederholt aufgerufen werden; wenn aktuell keine globale Hardwaretastatur vorhanden ist, wird ebenfalls Erfolg zurückgegeben.
• Während die globale Hardwaretastatur eine :press- oder :send_text-Sequenz ausführt, gibt die Trennung false, "hardware keyboard is busy" zurück.
• Mit key.down gedrückte Tasten werden beim Trennen freigegeben; das entsprechende key.up sendet danach keine Eingabe erneut.

Beispiel

local success, err = key.disconnect_global_keyboard()
assert(success, err)