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