! Подключение глобальной аппаратной клавиатуры (key.connect_global_keyboard)

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

Объявление

объект_клавиатуры, сообщение_об_ошибке = key.connect_global_keyboard([свойства_конфигурации])

Параметры

• Свойства конфигурации Таблица, необязательный параметр; использует те же свойства по умолчанию и ограничения, что и key.connect_keyboard.

Возвращаемое значение

• Объект аппаратной клавиатуры Объект аппаратной клавиатуры; при успехе подключения возвращается объект, при ошибке — nil.
• Сообщение об ошибке Строка; при ошибке подключения возвращает сообщение об ошибке.

При ошибке подключения два возвращаемых значения образуют nil, error.

Описание

Создаёт и подключает глобальную аппаратную клавиатуру. Во время ожидания подключения выполнение неявно уступается, поэтому до возврата функции другие потоки могут получить возможность работать.

• После подключения обычные клавиши и цифровая клавиатура из key.press, key.down, key.up, key.send_text и key(...):press/down/up вводятся через этот объект.
• Медиа-клавиши и пользовательские клавиши производителя сохраняют прежнее поведение.
• При отсутствии глобальной аппаратной клавиатуры поведение исходных интерфейсов не меняется.
• key.down и соответствующий key.up остаются парными: изменение состояния подключения между вызовами не приводит к повторному вводу или ошибочному отпусканию.
• Одновременно можно подключить только одну глобальную аппаратную клавиатуру. Повторный вызов до завершения подключения или при уже подключённой клавиатуре завершается ошибкой.

Пример

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())