Eine Taste der Hardwaretastatur drücken (:down)

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

Deklaration

Erfolgreich, Fehlermeldung = Hardwaretastatur-Objekt:down(Tastencode)
Erfolgreich, Fehlermeldung = Hardwaretastatur-Objekt:down(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

Drückt eine Taste der Hardwaretastatur. Nach dem Drücken sollte die entsprechende :up-Methode zum Loslassen aufgerufen werden.

• Während dieselbe Tastatur eine :press- oder :send_text-Sequenz ausführt, gibt diese Methode false, "hardware keyboard is busy" zurück.
• Gleichzeitig können höchstens 6 normale Tasten gedrückt gehalten werden; Modifikatortasten werden nicht mitgezählt. Bei Überschreitung kann das Zielsystem die einzelnen Tasten nicht erkennen.
• Bei einer fehlgeschlagenen Übertragung werden false und eine Fehlermeldung zurückgegeben; es wird nicht automatisch eine andere Eingabemethode versucht.

Beispiel

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- Keyboard A
assert(keyboard:down(0x07, 0xE1))    -- Left Shift
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())