Evento KeyPress

Ocorre quando o usuário pressiona uma tecla ANSI.

Sintaxe

Private Subobject _KeyPress( ByValKeyANSIAs MSForms.ReturnInteger)

A sintaxe do evento KeyPress tem as seguintes 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 utilizador prime uma tecla que produz um caráter escrevível (uma tecla ANSI) num formulário em execução enquanto o formulário ou um controlo no mesmo tem o foco. O evento pode ocorrer antes ou depois que a tecla é liberada. Este evento também ocorre se enviar uma combinação de teclas ANSI para um formulário ou controlo através da ação SendKeys numa macro ou da instrução SendKeys no Visual Basic.

Um evento KeyPress pode ocorrer quando qualquer uma das seguintes teclas é premida:

• Qualquer caráter de teclado imprimível
• CTRL combinado com um caráter do alfabeto padrão
• CTRL combinado com qualquer caráter especial
• BACKSPACE
• ESC

Um evento KeyPress não ocorre sob as seguintes condições:

• A premir a Tecla de Tabulação.
• Premir ENTER.
• Premir uma tecla de seta.
• Quando um pressionamento de tecla faz o foco mover de um controle para outro.

Observação

A TECLA DE RETROCESSO faz parte do conjunto de carateres ANSI, mas DELETE não. Eliminar um caráter num controlo com a TECLA DE RETROCESSO causa um evento KeyPress; eliminar um caráter utilizando DELETE não.

Quando um utilizador mantém premida uma chave que produz um código-chave ANSI, os eventos KeyDown e KeyPress alternam repetidamente. Quando o utilizador lança a chave, ocorre o evento KeyUp. O formulário ou controlo com o foco recebe todas as combinações de teclas. Um formulário só pode ter o foco se não tiver controlos ou se todos os respetivos controlos visíveis estiverem desativados.

A ação predefinida para o evento KeyPress é processar o código de evento que corresponde à chave que foi premida. KeyANSI indica o caráter ANSI que corresponde à combinação de teclas ou teclas premidas. O evento KeyPress interpreta as maiúsculas e minúsculas de cada caráter como códigos de chave separados e, portanto, como dois carateres separados.

Para responder ao estado físico do teclado ou para processar batimentos de teclas não reconhecidos pelo evento KeyPress, como teclas de função, teclas de navegação e quaisquer combinações destes com modificadores de teclado (ALT, SHIFT ou CTRL), utilize os procedimentos de eventos KeyDown e KeyUp.

A sequência de eventos relacionados com o teclado é:

1. KeyDown
2. KeyPress
3. KeyUp

Confira também

• Exemplos do Microsoft Forms
• Referência do Microsoft Forms
• Conceitos do Microsoft Forms

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.