Evento KeyPress
Ocorre quando o usuário pressiona uma tecla ANSI.
Sintaxe
Objeto Sub privado_KeyPress( ByValKeyANSIComo MSForms.ReturnInteger)
A sintaxe de evento KeyPress tem estas partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Um objeto válido. |
| KeyANSI | Obrigatório. Um valor inteiro que representa um código de chave ANSI numérico padrão. |
Comentários
O evento KeyPress ocorre quando o usuário pressiona uma chave que produz um caractere tipável (uma chave ANSI) em um formulário em execução enquanto o formulário ou um controle nele tem o foco. O evento pode ocorrer antes ou depois que a tecla é liberada. Esse evento também ocorrerá se você enviar uma tecla ANSI para um formulário ou controle usando a ação SendKeys em uma macro ou a instrução SendKeys no Visual Basic.
Um evento KeyPress pode ocorrer quando qualquer uma das seguintes chaves é pressionada:
- Qualquer caractere de teclado imprimível
- CTRL combinado com um caractere do alfabeto padrão
- CTRL combinado com qualquer caractere especial
- BACKSPACE
- ESC
Um evento KeyPress não ocorre sob as seguintes condições:
- Pressionando TAB.
- Pressionando ENTER.
- Pressionando uma tecla de seta.
- Quando um pressionamento de tecla faz o foco mover de um controle para outro.
Observação
O BACKSPACE faz parte do conjunto de caracteres ANSI, mas DELETE não é. Excluir um caractere em um controle usando o BACKSPACE causa um evento KeyPress; excluir um caractere usando DELETE não.
Quando um usuário segura uma chave que produz um código de chave ANSI, os eventos KeyDown e KeyPress alternam repetidamente. Quando o usuário libera a chave, o evento KeyUp ocorre. O formulário ou controle com o foco recebe todas as teclas. Um formulário só pode ter o foco se não tiver controles ou se todos os seus controles visíveis estiverem desabilitados.
A ação padrão para o evento KeyPress é processar o código de evento que corresponde à chave que foi pressionada. KeyANSI indica o caractere ANSI que corresponde à combinação de teclas ou teclas pressionadas. O evento KeyPress interpreta a maiúscula e minúscula de cada caractere como códigos-chave separados e, portanto, como dois caracteres separados.
Para responder ao estado físico do teclado ou para manipular teclas não reconhecidas pelo evento KeyPress, como teclas de função, teclas de navegação e quaisquer combinações delas com modificadores de teclado (ALT, SHIFT ou CTRL), use os procedimentos de evento KeyDown e KeyUp.
A sequência de eventos relacionados ao teclado é:
- KeyDown
- KeyPress
- KeyUp
Confira também
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.