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