Utilisation des événements du clavier

Mise à jour : novembre 2007

La plupart des programmes Windows Forms traitent l'entrée au clavier en gérant les événements de clavier. Cette rubrique fournit une vue d'ensemble des événements de clavier, y compris les détails indiquant quand utiliser chaque événement et les données qui sont fournies pour chaque événement.

Événements de clavier

Windows Forms fournit deux événements qui se produisent lorsque l'utilisateur appuie sur une touche de clavier et un événement lorsque l'utilisateur relâche une touche de clavier :

  • L'événement KeyDown se produit une fois

  • L'événement KeyPress, qui peut se produire plusieurs fois lorsque l'utilisateur maintient la même touche enfoncée.

  • L'événement KeyUp se produit une fois lorsque l'utilisateur relâche une touche.

Lorsque l'utilisateur appuie sur une touche, Windows Forms détermine quel événement déclencher selon que le message de clavier spécifie une touche de caractère ou une touche physique. Pour plus d'informations sur les touches de caractères et les touches physiques, consultez Fonctionnement de l'entrée au clavier.

Le tableau suivant décrit les trois événements de clavier.

Événements de clavier

Description

Résultats

KeyDown

Cet événement est déclenché lorsqu'un utilisateur appuie sur une touche physique.

Le gestionnaire de KeyDown reçoit :

  • Un paramètre KeyEventArgs qui fournit la propriété KeyCode (laquelle spécifie un bouton de clavier physique).

  • La propriété Modifiers (MAJ, CTRL ou ALT).

  • La propriété KeyData (qui combine le code de touche et le modificateur). Le paramètre KeyEventArgs fournit également :

    • La propriété Handled, qui peut être définie pour empêcher le contrôle sous-jacent de recevoir la touche.

    • La propriété SuppressKeyPress, qui peut être utilisée pour supprimer les événements KeyPress et KeyUp pour cette séquence de touches.

KeyPress

Cet événement est déclenché lorsqu'un appui sur une ou plusieurs touches se traduit par un caractère. Par exemple, un utilisateur appuie sur les touches MAJ et le caractère minuscule "a", ce qui donne un caractère "A" majuscule.

KeyPress est déclenché après KeyDown.

  • Le gestionnaire de KeyPress reçoit :

  • Un paramètre KeyPressEventArgs, qui contient le code de caractère de la touche qui a été enfoncée. Ce code de caractère est unique pour chaque combinaison d'une touche de caractère et d'une touche de modification.

    Par exemple, la touche "A" génère :

    • le code de caractère 65, si elle est actionnée avec la touche MAJ ;

    • la touche VERR.MAJ 97, si elle est actionnée seule ;

    • et 1, si elle est enfoncée avec la touche CTRL.

KeyUp

Cet événement est déclenché lorsqu'un utilisateur relâche une touche physique.

Le gestionnaire de KeyUp reçoit :

  • Un paramètre KeyEventArgs :

    • Lequel fournit la propriété KeyCode (qui spécifie un bouton de clavier physique).

    • La propriété Modifiers (MAJ, CTRL ou ALT).

    • La propriété KeyData (qui combine le code de touche et le modificateur).

Voir aussi

Concepts

Fonctionnement de l'entrée au clavier

Autres ressources

Entrée au clavier dans une application Windows Forms

Entrée de la souris dans une application Windows Forms

  • Last updated on