Usando Eventos do Teclado

A maioria dos aplicativos de Formulários do Windows processam a entrada do teclado exclusivamente manipulando eventos de teclado. Este tópico fornece uma visão geral dos eventos de teclado, incluindo detalhes sobre quando usar cada evento e os dados que são fornecidos para cada evento. Para obter mais informações, consulte Visão geral dos Manipuladores de Eventos (Formulários do Windows) e Visão Geral dos Eventos (Formulários do Windows) e Visão geral dos Manipuladores de Eventos (Formulários do Windows) e Visão Geral dos Eventos (Formulários do Windows) e Visão geral dos Manipuladores de Eventos (Formulários do Windows) e Visão Geral dos Eventos (Formulários do Windows) e Visão geral dos Manipuladores de Eventos (Formulários do Windows) e Visão Geral dos Eventos (Formulários do Windows).

Eventos de teclado.

Os Formulários do Windows fornecem dois eventos que ocorrem quando um usuário pressiona uma tecla do teclado e um evento quando um usuário libera uma tecla do teclado:

• O evento KeyDown ocorre uma vez

• O evento KeyPress, que pode ocorrer várias vezes quando um usuário segura a mesma tecla.

• O evento KeyUp ocorre uma vez quando um usuário libera uma tecla.

Quando um usuário pressiona uma tecla, os Formulários do Windows determinam qual evento gerar com base em se a mensagem do teclado especifica uma tecla de caractere ou física. Para obter mais informações sobre teclas de caracteres e físicas, consulte Como Funciona a Entrada do Teclado.

A tabela a seguir descreve os três eventos de teclado.

Evento de teclado.	Descrição	Resultados
KeyDown	Este evento é gerado quando um usuário pressiona uma tecla física.	O manipulador de KeyDown recebe: Um parâmetro KeyEventArgs, que fornece a propriedade KeyCode (que especifica um botão físico do teclado). A propriedade Modifiers (SHIFT, CTRL ou ALT). A propriedade KeyData (que combina o código de tecla e modificadora). O parâmetro KeyEventArgs também fornece: A propriedade Handled, que pode ser definida para evitar que o controle subjacente receba a chave. A propriedade SuppressKeyPress, que pode ser usada para suprimir os eventos KeyPress e KeyUp para este pressionamento de tecla.
KeyPress	Este evento é gerado quando a tecla ou teclas pressionadas resultado em um caractere. Por exemplo, um usuário pressiona as teclas SHIFT e "a" minúsculo, que resultam em uma caractere maiúsculo "A".	KeyPress é gerado após KeyDown. O manipulador de KeyPress recebe: Um parâmetro KeyPressEventArgs, que contém o código do caractere da tecla que foi pressionada. Este código de caractere é exclusivo de cada combinação de tecla de caracteres e tecla modificadora. Por exemplo, a tecla "A" gerará: O código de caractere 65, se ela estiver pressionada com a tecla SHIFT Ou a tecla CAPS LOCK, 97 se ela estiver pressionada por si só, E 1, se ela estiver pressionada com a tecla CTRL.
KeyUp	Este evento é gerado quando um usuário solta uma tecla física.	O manipulador de KeyUp recebe: Um parâmetro KeyEventArgs: Que fornece a propriedade KeyCode, (que especifica um botão físico do teclado). A propriedade Modifiers (SHIFT, CTRL ou ALT). A propriedade KeyData (que combina o código de tecla e modificadora).

Consulte também

Conceitos

Como Funciona a Entrada do Teclado

Outros recursos

A Entrada do Teclado em um aplicativo de Formulários do Windows

Entrada do Mouse em um Aplicativo de Formulários do Windows