メインコンテンツまでスキップ

テキストを追加入力する (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 を使用しています。