Ввод текста (key.input_text)

Функция доступна в версиях после 20260816.

Объявление

успех, сообщение_об_ошибке = key.input_text(текст [, нажать_Enter_после_ввода ])

Параметры

• Текст Строка, вводимый текст UTF-8, может быть пустым; "\b" выполняет удаление предыдущего символа.
• Нажать Enter после ввода Логическое значение: нажимать ли клавишу Enter после ввода; по умолчанию 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)