Método Application.OnKey (Excel)
Executa um procedimento especificado quando uma tecla ou uma combinação de teclas em particular é pressionada.
Sintaxe
expressão. OnKey (Chave, Procedimento)
expressão Uma variável que representa um Aplicativo objeto.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Tecla | Obrigatório | String | Uma cadeia de caracteres que indica a tecla a ser pressionada. |
| Procedure | Opcional | Variant | Uma cadeia de caracteres que indica o nome do procedimento a ser executado. Se o Procedimento for "" (texto vazio), nada acontecerá quando a chave é pressionada. Esse formato de OnKey altera o resultado normal de pressionamentos de tecla no Microsoft Excel. Se procedimento for omitido tecla será revertida para seu resultado normal no Microsoft Excel e as atribuições de teclas especiais feitas com os métodos anteriores OnKey são limpas. |
Comentários
O argumento Key pode especificar qualquer chave única combinada com Alt, Ctrl ou Shift ou qualquer combinação dessas chaves. Cada tecla é representada por um ou mais caracteres, como a para o caractere a, ou {ENTER} para a tecla Enter.
Para especificar caracteres que não são exibidos quando você pressiona a chave correspondente (por exemplo: Enter ou Tab), use os códigos listados na tabela a seguir. Cada código da tabela representa uma tecla no teclado.
| Chave | Código |
|---|---|
| BACKSPACE | {BACKSPACE} ou {BS} |
| BREAK | {BREAK} |
| CAPS LOCK | {CAPSLOCK} |
| CLEAR | {CLEAR} |
| DELETE ou DEL | {DELETE} ou {DEL} |
| SETA PARA BAIXO | {DOWN} |
| TÉRMINO | {END} |
| ENTER (teclado numérico) | {ENTER} |
| ENTER | ~ (til) |
| ESC | { ESCAPE} ou {ESC} |
| AJUDA | {HELP} |
| PÁGINA INICIAL | {HOME} |
| INS | {INSERT} |
| SETA PARA A ESQUERDA | {LEFT} |
| NUM LOCK | {NUMLOCK} |
| PAGE DOWN | {PGDN} |
| PAGE UP | {PGUP} |
| RETURN | {RETURN} |
| SETA PARA A DIREITA | {RIGHT} |
| SCROLL LOCK | {SCROLLLOCK} |
| TAB | {TAB} |
| SETA PARA CIMA | {UP} |
| F1 a F15 | {F1} a {F15} |
Você também pode especificar chaves combinadas com Shift e/ou Ctrl e/ou Alt e/ou Comando. Para especificar uma chave combinada por outra tecla ou teclas, use a tabela a seguir.
| Para combinar teclas a | Preceda o código de tecla com |
|---|---|
| Shift | + (sinal de mais) |
| Ctrl | ^ (circunflexo) |
| Alt | % (sinal de porcentagem) |
| Comando | * (asterisco) Aplica-se apenas ao Mac; só pode funcionar no Excel 2011 para Mac e não em versões posteriores. |
Para atribuir um procedimento para um dos caracteres especiais (+, ^, % e assim por diante), coloque o caractere entre chaves. Para obter detalhes, veja o exemplo.
Observação
No momento, não há como detectar a chave de comando em versões recentes do Office VBA. A Microsoft está ciente disso e está investigando isso.
Exemplo
Este exemplo atribui InsertProc à sequência de chaves Ctrl+Plus Sign e atribui SpecialPrintProc à sequência de chaves Shift+Ctrl+Seta para a direita.
Application.OnKey "^{+}", "InsertProc"
Application.OnKey "+^{RIGHT}", "SpecialPrintProc"
Este exemplo retorna Shift+Ctrl+Seta para a direita ao seu significado normal.
Application.OnKey "+^{RIGHT}"
Este exemplo desabilita a sequência de teclas Shift+Ctrl+Seta para a direita.
Application.OnKey "+^{RIGHT}", ""
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.