テキストを入力する (key.input_text)
この関数は 20260816 以降のバージョンでのみ使用できます
宣言
成功, エラーメッセージ = key.input_text(テキスト内容 [, 入力後にエンターキーを押すかどうか ])
引数
- テキスト内容
文字列。入力する UTF-8 テキストです。空でもかまいません。含まれている
"\b"ごとにバックスペース操作を実行します - 入力後にエンターキーを押すかどうか ブール値。入力完了後にキーボードのエンターキーを押すかどうかを指定します。デフォルトは false です
戻り値
- 成功
ブール値。入力シミュレーション操作の送信に成功した場合は
true、失敗した場合はfalseを返します - エラーメッセージ 文字列。失敗した場合にエラーの原因を返します
説明
インプットメソッドで選択した文字を確定する操作をシミュレートし、フォアグラウンドアプリでフォーカスされている入力欄にテキストを入力します
この関数はシステムの共有クリップボードを読み取ったり変更したりしません
この関数ではパスワード入力欄にテキストを入力できません。パスワード入力欄では
sys.input_textを使用してください
trueが返されても、入力シミュレーション操作が送信されたことを示すだけで、対象の入力欄がテキストを受け付けたことを保証するものではありません
例
local ok, err = key.input_text("你好，XXTouch 🙂")
assert(ok, err)
--
local ok, err = key.input_text("hello!\b", true)
assert(ok, err)