Pular para o conteúdo principal

Soltar uma tecla do teclado de hardware (:up)

Este método está disponível somente a partir da versão 20260805.

Declarações​

sucesso, mensagem_de_erro = objeto_teclado:up(codigo_da_tecla)
sucesso, mensagem_de_erro = objeto_teclado:up(Usage_Page, Usage_ID)

Parâmetros​

  • codigo_da_tecla
    Texto; usa o mesmo mapeamento de nomes de teclas que key.press.
  • Usage Page
    Inteiro; o objeto de teclado de hardware atual aceita somente a Keyboard/Keypad Usage Page 0x07.
  • Usage ID
    Inteiro; número da tecla física, não uma codificação de caractere.

Valores retornados​

  • sucesso
    Booleano; retorna true quando o envio é bem-sucedido e false quando falha.
  • mensagem_de_erro
    Texto; retorna a mensagem de erro quando o envio falha.

Descrição​

Solta uma tecla do teclado de hardware pressionada anteriormente por :down.

Se o mesmo teclado estiver executando uma sequência :press ou :send_text, este método retornará false, "hardware keyboard is busy". Quando o envio falha, não tenta automaticamente outro método de entrada.

Exemplo​

local keyboard = assert(key.connect_keyboard())

assert(keyboard:down("LEFTSHIFT"))
assert(keyboard:up("LEFTSHIFT"))

assert(keyboard:disconnect())