Evento KeyPress

Ocorre quando o usuário pressiona uma tecla ANSI.

Sintaxe

Subobjeto privado _KeyPress( ByValKeyANSIAs 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 tecla ANSI numérico padrão.

Comentários

O evento KeyPress ocorre quando o usuário pressiona uma tecla que produz um caractere digitável (uma tecla 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 ocorre se você enviar um pressionamento de 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 teclas é 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:

  • Pressionar TAB.
  • pressionando ENTER.
  • Pressionando uma tecla de direção.
  • Quando um pressionamento de tecla faz o foco mover de um controle para outro.

Observação

BACKSPACE faz parte do conjunto de caracteres ANSI, mas DELETE não. Excluir um caractere em um controle usando BACKSPACE causa um evento KeyPress; excluir um caractere usando DELETE não.

Quando um usuário mantém pressionada uma tecla que produz um código de tecla ANSI, os eventos KeyDown e KeyPress se alternam repetidamente. Quando o usuário libera a chave, ocorre o evento KeyUp. O formulário ou controle com o foco recebe todos os pressionamentos de tecla. Um formulário só poderá ter o foco se não tiver controles ou se todos os controles visíveis estiverem desabilitados.

A ação padrão para o evento KeyPress é processar o código de evento que corresponde à tecla que foi pressionada. KeyANSI indica o caractere ANSI que corresponde à tecla pressionada ou à combinação de teclas. O evento KeyPress interpreta as letras maiúsculas e minúsculas de cada caractere como códigos de tecla separados e, portanto, como dois caracteres separados.

Para responder ao estado físico do teclado ou para manipular pressionamentos de tecla não reconhecidos pelo evento KeyPress, como teclas de função, teclas de navegação e qualquer combinação 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 é:

  1. KeyDown
  2. KeyPress
  3. 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.

  • Last updated on