Partager via

Utilisation des événements du clavier

  • Article

La plupart des programmes Windows Forms traitent l’entrée du clavier en gérant les événements de clavier. Cette rubrique fournit une vue d’ensemble des événements de clavier, y compris des détails sur le moment où utiliser chaque événement et les données fournies pour chaque événement. Consultez également Vue d’ensemble des gestionnaires d’événements (Windows Forms) et Vue d’ensemble des événements (Windows Forms).

Événements de clavier

Windows Forms fournit deux événements qui se produisent lorsqu’un utilisateur appuie sur une touche clavier et un événement lorsqu’un utilisateur libère une touche de clavier :

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

  • Événement KeyPress, qui peut se produire plusieurs fois lorsqu’un utilisateur conserve la même clé.

  • L’événement KeyUp se produit une fois lorsqu’un utilisateur libère une clé.

Lorsqu’un utilisateur appuie sur une touche, Windows Forms détermine l’événement à déclencher selon que le message clavier spécifie une touche de caractère ou une touche physique. Pour plus d’informations sur les touches physiques et les caractères, consultez Fonctionnement de l’entrée 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 :

  • Paramètre KeyEventArgs, qui fournit la propriété KeyCode (qui spécifie un bouton de clavier physique).
  • la propriété Modifiers (Maj, Ctrl ou Alt) ;
  • Propriété KeyData (qui combine le code de clé et le modificateur). Le paramètre KeyEventArgs fournit également les éléments suivants :

    • Propriété Handled, qui peut être définie pour empêcher le contrôle sous-jacent de recevoir la clé.
    • 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é quand la ou les touches enfoncées génèrent un caractère. Par exemple, l'utilisateur appuie sur les touches Maj et « a », ce qui produit un caractère « A » majuscule. KeyPress est déclenché après KeyDown.

  • Le gestionnaire de KeyPress reçoit :
  • 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 modificateur.

    Par exemple, la clé « A » génère :

    • le code de caractère 65, si elle est enfoncée avec la touche Maj ;
    • ou la touche Verr. Maj, 97, si elle est activée seule,
    • Et 1, si elle est enfoncée avec la touche Ctrl.
KeyUp Cet événement est déclenché lorsqu’un utilisateur libère une clé physique. Le gestionnaire de KeyUp reçoit :

  • un paramètre KeyEventArgs :

    • Qui fournit la propriété KeyCode (qui spécifie un bouton de clavier physique).
    • la propriété Modifiers (Maj, Ctrl ou Alt) ;
    • Propriété KeyData (qui combine le code de clé et le modificateur).

Voir aussi