Zum Hauptinhalt springen

! Text mit der Hardwaretastatur eingeben (:send_text)

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

Deklaration​

Erfolgreich, Fehlermeldung = Hardwaretastatur-Objekt:send_text(Text[, Verzögerung_pro_Taste, Shift-Tastenverzögerung])

Parameter​

  • Text Text, einzugebender Inhalt; unterstützt nur englische Buchstaben, Ziffern, Leerzeichen, Halbbreitenzeichen sowie "\b", "\r" und "\t".
  • Verzögerung_pro_Taste Reelle Zahl, optionaler Parameter, Verzögerung zwischen den Tastenoperationen in Millisekunden, standardmäßig 0.
  • Shift-Tastenverzögerung Reelle Zahl, optionaler Parameter, Verzögerung vor und nach dem Drücken oder Loslassen der Umschalttaste in Millisekunden, standardmäßig 0.

Rückgabewerte​

  • Erfolgreich Boolescher Wert; wenn der gesamte Text erfolgreich gesendet wurde true, bei Fehler false.
  • Fehlermeldung Text; bei fehlgeschlagener Übertragung wird die Fehlermeldung zurückgegeben.

Hinweise​

Erzeugt Tasten und Umschaltkombinationen anhand der aktuellen US-Tastaturzuordnung von Lua. Während des Wartens bei der Eingabe wird die Ausführung implizit abgegeben; vor der Rückgabe der Methode können andere Threads ausgeführt werden.

  • Die endgültig eingegebenen Zeichen hängen weiterhin vom Tastaturlayout des Zielsystems ab.
  • Diese Methode schützt normale Tasten und Modifikatortasten, die vor dem Aufruf bereits gedrückt waren.
  • Während dieselbe Hardwaretastatur eine :press- oder :send_text-Sequenz ausführt, gibt die neue Operation 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:send_text("Hello"))
assert(keyboard:send_text("Hello", 30, 10))

assert(keyboard:disconnect())