Zum Hauptinhalt springen

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