! Texteingabe simulieren (key.send_text)

Die in dieser Seite beschriebenen Hardwaretastatur-Funktionen sind erst in Versionen nach 20260805 verfügbar.

Deklaration

key.send_text(Text [, Verzögerung_pro_Taste, Shift-Tastenverzögerung])

Text Text, einzugebender Inhalt; nur englische Buchstaben, Ziffern, Leerzeichen, Halbbreitenzeichen sowie "\b", "\r" und "\t".
Verzögerung_pro_Taste Ganzzahl, Verzögerung zwischen den Tasten in Millisekunden; standardmäßig keine Verzögerung, Eingabe mit der maximalen Geräteleistung.
Shift-Tastenverzögerung Ganzzahl in Millisekunden; für Großbuchstaben oder bestimmte Sonderzeichen muss Shift gedrückt gehalten werden, beispielsweise ist @ Shift + 2.

Diese Funktion kann eine Tastatureingabe erzwingen, wenn sys.input_text nicht funktioniert.

Nach dem Verbinden einer globalen Hardwaretastatur wird der Text über dieses Objekt eingegeben; ohne globale Hardwaretastatur bleibt das Verhalten unverändert.
Die Hardwaretastatur erzeugt Tasten und Umschaltkombinationen anhand der aktuellen US-Tastaturzuordnung von Lua; die endgültigen Zeichen hängen weiterhin vom Tastaturlayout des Zielsystems ab.
Bei der Eingabe über die Hardwaretastatur werden die vor dem Aufruf bereits gedrückten Tasten geschützt; bei einer fehlgeschlagenen Übertragung wird nicht automatisch die bisherige Eingabemethode versucht.

key.send_text("AbC12#") -- Text so schnell wie möglich eingeben
--
key.send_text("AbC12#", 300) -- Zwischen jeder Eingabe 0,3 Sekunden warten