Text eingeben (key.input_text)

Diese Funktion ist erst in Versionen nach 20260816 verfügbar.

Deklaration

Erfolgreich, Fehlermeldung = key.input_text(Textinhalt [, Nach_Eingabe_Enter_drücken ])

Parameter

• Textinhalt
  Text, einzugebender UTF-8-Text, darf leer sein; "\b" führt einen Rückschritt aus
• Nach_Eingabe_Enter_drücken
  Boolescher Wert, ob nach Abschluss der Eingabe die Eingabetaste gedrückt werden soll, standardmäßig false

Rückgabewerte

• Erfolgreich
  Boolescher Wert; wenn die simulierte Eingabe erfolgreich ausgelöst wurde true, bei Fehler false
• Fehlermeldung
  Text; bei Fehler wird die Fehlerursache zurückgegeben

Hinweise

Gibt Text durch die Zeichenauswahl einer simulierten Eingabemethode in ein Eingabefeld ein, das in der Anwendung im Vordergrund bereits den Fokus hat.

Diese Funktion liest oder ändert die allgemeine Systemzwischenablage nicht.

Diese Funktion kann keinen Text in ein Passworteingabefeld eingeben; verwenden Sie für Passworteingabefelder sys.input_text.

Der Rückgabewert true bedeutet nur, dass die simulierte Eingabe ausgelöst wurde; er bedeutet nicht, dass das Zieleingabefeld den Text tatsächlich angenommen hat.

Beispiel

local ok, err = key.input_text("你好，XXTouch 🙂")
assert(ok, err)
--
local ok, err = key.input_text("hello!\b", true)
assert(ok, err)