Simular o pressionamento de uma tecla física (key.down)

As funções de teclado de hardware descritas nesta página estão disponíveis somente a partir da versão 20260805.

Declaração

key.down(codigo_da_tecla)

Parâmetros

• codigo_da_tecla Texto; código da tecla física. Consulte os códigos na seção Exemplos e lista de códigos de tecla compatíveis.

Descrição

Simula o pressionamento de uma tecla física. Atenção: quando não houver um teclado de hardware global conectado, esta função deve ter uma chamada key.up correspondente; caso contrário, a tecla poderá permanecer pressionada após o término do script. O teclado de hardware global libera todas as teclas pressionadas ao ser desconectado ou quando o script é interrompido.

• Depois de conectar um teclado de hardware global, as teclas comuns e do teclado numérico são inseridas por esse objeto; as teclas de mídia e as teclas personalizadas do fabricante mantêm o comportamento original.
• Esta função permanece pareada com o key.up correspondente. Se o teclado de hardware já estiver desconectado, a tecla será liberada durante a desconexão e o key.up posterior não enviará outra entrada.
• A chamada por key(...):down() segue as mesmas regras.

Exemplo

Consulte o exemplo abrangente no final deste capítulo.