Saltar al contenido principal

Pulsar una tecla del teclado de hardware (:down)

Este método solo está disponible a partir de las versiones posteriores a 20260805

Declaración​

éxito, mensaje_error = objeto_teclado_hardware:down(código_tecla)
éxito, mensaje_error = objeto_teclado_hardware:down(Usage_Page, Usage_ID)

Parámetros​

  • Código de tecla Tipo texto; utiliza el mismo mapeo de nombres de teclas que key.press.
  • Usage Page Tipo entero; el objeto de teclado de hardware actual solo acepta Keyboard/Keypad Usage Page 0x07.
  • Usage ID Tipo entero; número de la tecla física, no una codificación de caracteres.

Valor devuelto​

  • Éxito Tipo booleano; devuelve true si el envío tiene éxito y false si falla.
  • Mensaje de error Tipo texto; devuelve el mensaje de error cuando el envío falla.

Descripción​

Pulsa una tecla del teclado de hardware. Después de pulsarla, se debe llamar a :up para soltarla.

  • Si el mismo teclado está ejecutando una secuencia de :press o :send_text, el método devuelve false, "hardware keyboard is busy".
  • Se pueden mantener pulsadas como máximo 6 teclas normales a la vez; las teclas modificadoras no cuentan. Si se supera el límite, el sistema objetivo no puede identificar las teclas concretas.
  • Si el envío falla, devuelve false y el mensaje de error, sin reintentar automáticamente con otro método de entrada.

Ejemplo​

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- Tecla A del teclado
assert(keyboard:down(0x07, 0xE1))    -- Shift izquierdo
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())