Hardwaretastatur trennen (:disconnect)

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

Deklaration

Erfolgreich, Fehlermeldung = Hardwaretastatur-Objekt:disconnect()

Erfolgreich Boolescher Wert; bei erfolgreicher Trennung true, bei Fehler false.
Fehlermeldung Text; bei fehlgeschlagener Trennung wird die Fehlermeldung zurückgegeben.

Gibt alle Tasten frei und trennt dieses Hardwaretastatur-Objekt.

Diese Methode kann wiederholt aufgerufen werden.
Wenn das Objekt die aktuelle globale Hardwaretastatur ist, wird mit dieser Methode auch die globale Tastaturverbindung gelöscht.
Während dieselbe Hardwaretastatur eine :press- oder :send_text-Sequenz ausführt, gibt diese Methode false, "hardware keyboard is busy" zurück.
Wenn Lua das Hardwaretastatur-Objekt freigibt oder das Skript beendet wird, gibt XXTouch ebenfalls automatisch alle Tasten frei und trennt das Objekt.

local keyboard = assert(key.connect_keyboard())

local success, err = keyboard:disconnect()
assert(success, err)