Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 Procedimento for "" (texto vazio), nada acontece quando a tecla é premida. 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 Chave pode especificar qualquer tecla única combinada com Alt, Ctrl ou Shift ou qualquer combinação destas teclas. Cada tecla é representada por um ou mais caracteres, como a para o caractere a, ou {ENTER} para a tecla Enter.
Para especificar carateres que não são apresentados quando prime a tecla correspondente (por exemplo: Enter ou Tabulação), utilize os códigos listados na tabela seguinte. 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} |
Também pode especificar teclas 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
Atualmente, não existe forma de detetar a chave de Comando em versões recentes do VBA do Office. A Microsoft está ciente disso e está a analisar o problema.
Exemplo
Este exemplo atribui InsertProc à sequência de teclas Ctrl+Sinal de Adição e atribui SpecialPrintProc à sequência de teclas Shift+Ctrl+Seta Para a Direita.
Application.OnKey "^{+}", "InsertProc"
Application.OnKey "+^{RIGHT}", "SpecialPrintProc"
Este exemplo devolve Shift+Ctrl+Seta Para a Direita para o seu significado normal.
Application.OnKey "+^{RIGHT}"
Este exemplo desativa 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.