Перейти к основному содержимому

Ввод текста (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)