Compartilhar via


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.

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