追加輸入文字 (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