Eine Taste der Hardwaretastatur loslassen (:up)

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

Deklaration

Erfolgreich, Fehlermeldung = Hardwaretastatur-Objekt:up(Tastencode)
Erfolgreich, Fehlermeldung = Hardwaretastatur-Objekt:up(Usage_Page, Usage_ID)

Parameter

• Tastencode Text; verwendet dieselbe Tastennamenzuordnung wie key.press.
• Usage Page Ganzzahl; das aktuelle Hardwaretastatur-Objekt akzeptiert nur die Keyboard/Keypad Usage Page 0x07.
• Usage ID Ganzzahl, Nummer der physischen Taste, keine Zeichenkodierung.

Rückgabewerte

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

Hinweise

Lässt eine zuvor mit :down gedrückte Taste der Hardwaretastatur los.

Während dieselbe Tastatur eine :press- oder :send_text-Sequenz ausführt, gibt diese Methode false, "hardware keyboard is busy" zurück. Bei einer fehlgeschlagenen Übertragung wird nicht automatisch eine andere Eingabemethode versucht.

Beispiel

local keyboard = assert(key.connect_keyboard())

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

assert(keyboard:disconnect())