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