テキストを追加入力する (ui_element.input_text)

この関数は 20260507 以降のバージョンでのみ使用できます

宣言

状態, 情報またはエラー情報 = ui_element.input_text(セレクターまたは要素, テキスト [, オプション ])

引数

• セレクターまたは要素 テーブル型。セレクター、検索で返された要素、または座標テーブル { x = 横座標, y = 縦座標 } を指定できます。
• テキスト 文字列型。追加入力する内容です。
• オプション 省略可能なテーブル型。共通オプションの説明を参照してください。

戻り値

• 状態 ブール型。成功した場合は true、失敗した場合は nil です。
• 情報またはエラー情報 成功した場合はテーブル型の操作情報、失敗した場合は文字列型のエラー理由です。

説明

このインターフェースは、先にテキスト入力対象を特定してからテキストを追加入力します。 既存のテキストを置き換える場合は、set_text を使用してください。

使用例

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.input_text({
    title = "搜索",
    role = "text_field",
}, "XXTouch")

if not ok then
    sys.toast(info_or_err)
end

注記：上記のコードでは、この章で扱っていない関数 sys.toast を使用しています。