Partager via

Vue d’ensemble de l’utilisation du clavier (Windows Forms .NET)

  • Article

Dans Windows Forms, l’entrée utilisateur est envoyée aux applications sous la forme de messages Windows . Une série de méthodes substituables traite ces messages au niveau de l’application, du formulaire et du contrôle. Lorsque ces méthodes reçoivent des messages clavier, elles déclenchent des événements qui peuvent être gérés pour obtenir des informations sur l’entrée du clavier. Dans de nombreux cas, les applications Windows Forms pourront traiter toutes les entrées utilisateur simplement en gérant ces événements. Dans d’autres cas, une application peut avoir besoin de remplacer l’une des méthodes qui traitent les messages afin d’intercepter un message particulier avant qu’il soit reçu par l’application, le formulaire ou le contrôle.

Événements de clavier

Tous les contrôles Windows Forms héritent d’un ensemble d’événements liés à l’entrée de la souris et du clavier. Par exemple, un contrôle peut gérer l’événement KeyPress pour déterminer le code de caractère d’une touche qui a été enfoncée. Pour plus d’informations, consultez Utilisation des événements de clavier.

Méthodes qui traitent les messages d’entrée utilisateur

Les formulaires et les contrôles ont accès à l’interface IMessageFilter et à un ensemble de méthodes substituables qui traitent les messages Windows à différents points de la file d’attente des messages. Ces méthodes ont tous un paramètre Message, qui encapsule les détails de bas niveau des messages Windows. Vous pouvez implémenter ou remplacer ces méthodes pour examiner le message, puis consommer le message ou le transmettre au consommateur suivant dans la file d’attente de messages. Le tableau suivant présente les méthodes qui traitent tous les messages Windows dans Windows Forms.

Méthode Notes
PreFilterMessage Cette méthode intercepte les messages Windows mis en file d’attente (également appelés publiés) au niveau de l’application.
PreProcessMessage Cette méthode intercepte les messages Windows au niveau du formulaire et du contrôle avant qu’ils n’aient été traités.
WndProc Cette méthode traite les messages Windows au niveau du formulaire et du contrôle.
DefWndProc Cette méthode effectue le traitement par défaut des messages Windows au niveau du formulaire et du contrôle. Cela fournit les fonctionnalités minimales d’une fenêtre.
OnNotifyMessage Cette méthode intercepte les messages au niveau du formulaire et du contrôle, une fois qu’elles ont été traitées. Le bit de style EnableNotifyMessage doit être défini pour que cette méthode soit appelée.

Les messages clavier et souris sont également traités par un ensemble supplémentaire de méthodes substituables spécifiques à ces types de messages. Pour plus d’informations, consultez la section clés de prétraitement. .

Types de clés

Windows Forms identifie l’entrée au clavier en tant que codes de touche virtuelle représentés par l’énumération Keys au niveau du bit. Avec l’énumération Keys, vous pouvez combiner une série de touches enfoncées pour générer une valeur unique. Ces valeurs correspondent aux valeurs qui accompagnent les messages WM_KEYDOWN et WM_SYSKEYDOWN Windows. Vous pouvez détecter la plupart des pressions de touches physiques en gérant les événements KeyDown ou KeyUp. Les clés de caractères sont un sous-ensemble de l’énumération Keys et correspondent aux valeurs qui accompagnent les messages WM_CHAR et WM_SYSCHAR Windows. Si la combinaison de touches enfoncées entraîne un caractère, vous pouvez détecter le caractère en gérant l’événement KeyPress.

Ordre des événements de clavier

Comme indiqué précédemment, il existe 3 événements liés au clavier qui peuvent se produire sur un contrôle. La séquence suivante montre l’ordre général des événements :

  1. L'utilisateur appuie sur la touche « a », la touche est prétraitée, dispatchée, et un événement KeyDown se produit.
  2. L’utilisateur contient la clé « a », la clé est prétraite, distribuée et un événement KeyPress se produit. Cet événement se produit plusieurs fois lorsque l’utilisateur appuie sur une touche.
  3. L’utilisateur libère la clé « a », la clé est prétraite, distribuée et un événement KeyUp se produit.

Prétraitement des clés

Comme d’autres messages, les messages clavier sont traités dans la méthode WndProc d’un formulaire ou d’un contrôle. Toutefois, avant le traitement des messages clavier, la méthode PreProcessMessage appelle une ou plusieurs méthodes qui peuvent être substituées pour gérer des touches de caractères spéciales et des touches physiques. Vous pouvez remplacer ces méthodes pour détecter et filtrer certaines clés avant que les messages ne soient traités par le contrôle. Le tableau suivant montre l’action en cours d’exécution et la méthode associée qui se produit, dans l’ordre dans lequel la méthode se produit.

Prétraitement d’un événement KeyDown

Action Méthode associée Notes
Recherchez une touche de commande telle qu'un accélérateur ou un raccourci de menu. ProcessCmdKey Cette méthode traite une clé de commande, qui est prioritaire sur les clés régulières. Si cette méthode retourne true, le message de clé n’est pas distribué et un événement de clé ne se produit pas. Si elle retourne false, IsInputKey est appelée.
Recherchez une clé spéciale qui nécessite un prétraitement ou une clé de caractère normale qui doit déclencher un événement de KeyDown et être distribuée à un contrôle. IsInputKey Si la méthode retourne true, cela signifie que le contrôle est un caractère standard et qu’un événement KeyDown est déclenché. Si false, ProcessDialogKey est appelé. Remarque : Pour vous assurer qu’un contrôle obtient une clé ou une combinaison de clés, vous pouvez gérer l’événement PreviewKeyDown et définir IsInputKey de l'PreviewKeyDownEventArgs sur true pour la clé ou les clés souhaitées.
Recherchez une touche de navigation (ÉCHAP, TAB, Retour ou touches de direction). ProcessDialogKey Cette méthode traite une clé physique qui utilise des fonctionnalités spéciales dans le contrôle, telles que le basculement du focus entre le contrôle et son parent. Si le contrôle immédiat ne gère pas la clé, la ProcessDialogKey est appelée sur le contrôle parent, puis jusqu'au contrôle le plus haut de la hiérarchie. Si cette méthode retourne true, le prétraitement est terminé et un événement clé n’est pas généré. Si elle retourne false, un événement KeyDown se produit.

Prétraitement d’un événement KeyPress

Action Méthode associée Notes
Vérifier que la clé est un caractère normal qui doit être traité par le contrôle IsInputChar Si le caractère est un caractère normal, cette méthode retourne true, l’événement KeyPress est déclenché et aucun prétraitement supplémentaire ne se produit. Sinon, ProcessDialogChar sera appelée.
Vérifiez si le caractère est un mnémonique (par exemple, &OK sur un bouton) ProcessDialogChar Cette méthode, similaire à ProcessDialogKey, sera appelée dans la hiérarchie de contrôle. Si le contrôle est un contrôle conteneur, il vérifie les mnémoniques en appelant ProcessMnemonic sur lui-même et sur ses contrôles enfants. Si ProcessDialogChar retourne true, un événement KeyPress ne se produit pas.

Traitement des messages clavier

Une fois que les messages clavier atteignent la méthode WndProc d’un formulaire ou d’un contrôle, ils sont traités par un ensemble de méthodes qui peuvent être substituées. Chacune de ces méthodes retourne une valeur Boolean spécifiant si le message clavier a été traité et consommé par le contrôle. Si l’une des méthodes retourne true, le message est considéré comme géré et il n’est pas passé à la base ou au parent du contrôle pour un traitement ultérieur. Sinon, le message reste dans la file d'attente des messages et peut être traité par une autre méthode dans la classe de base ou la classe parente du contrôle. Le tableau suivant présente les méthodes qui traitent les messages clavier.

Méthode Notes
ProcessKeyMessage Cette méthode traite tous les messages clavier reçus par la méthode WndProc du contrôle.
ProcessKeyPreview Cette méthode envoie le message clavier au parent du contrôle. Si ProcessKeyPreview retourne true, aucun événement de clé n’est généré, sinon ProcessKeyEventArgs est appelé.
ProcessKeyEventArgs Cette méthode déclenche les événements KeyDown, KeyPresset KeyUp, le cas échéant.

Surcharge des méthodes de clavier

De nombreuses méthodes sont disponibles pour le remplacement lorsqu’un message clavier est prétraité et traité ; cependant, certaines méthodes sont beaucoup plus préférables à d'autres. Le tableau suivant présente les tâches que vous souhaiterez peut-être accomplir et la meilleure façon de remplacer les méthodes de clavier. Pour plus d’informations sur la substitution de méthodes, consultez Héritage (Guide de programmation C#) ou Héritage (Visual Basic)

Tâche Méthode
Interceptez une touche de navigation et générez un événement KeyDown. Par exemple, vous souhaitez que tabulation et retour soient gérés dans une zone de texte. Remplacer IsInputKey. Remarque : vous pouvez également gérer l’événement PreviewKeyDown et définir IsInputKey de l'PreviewKeyDownEventArgs sur true pour la clé ou les clés souhaitées.
Effectuez une gestion spéciale de l’entrée ou de la navigation sur un contrôle. Par exemple, vous souhaitez utiliser des touches de direction dans votre contrôle de liste pour modifier l’élément sélectionné. Remplacer ProcessDialogKey
Interceptez une touche de navigation et générez un événement KeyPress. Par exemple, dans un contrôle spin-box, vous souhaitez appuyer sur plusieurs touches de direction pour accélérer la progression dans les éléments. Remplacer IsInputChar.
Effectuez une gestion spéciale de l’entrée ou de la navigation pendant un événement KeyPress. Par exemple, dans un contrôle de liste, maintenir la touche « r » enfoncée permet de passer entre les éléments qui commencent par la lettre r. Remplacer ProcessDialogChar
Effectuer une gestion mnémonique personnalisée ; par exemple, vous souhaitez gérer des mnemonics sur des boutons dessinés par le propriétaire contenus dans une barre d’outils. Remplacer ProcessMnemonic.

Voir aussi