ContextMenu.ProcessCmdKey(Message, Keys, Control) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Traite une touche de commande.

protected public:
 virtual bool ProcessCmdKey(System::Windows::Forms::Message % msg, System::Windows::Forms::Keys keyData, System::Windows::Forms::Control ^ control);

protected internal virtual bool ProcessCmdKey (ref System.Windows.Forms.Message msg, System.Windows.Forms.Keys keyData, System.Windows.Forms.Control control);

override this.ProcessCmdKey : Message * System.Windows.Forms.Keys * System.Windows.Forms.Control -> bool

Protected Friend Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys, control As Control) As Boolean

Paramètres

msg

Message

Message, passé par référence, qui représente le message de fenêtre à traiter.

keyData

Keys

Une des valeurs Keys qui représente la touche à traiter.

control

Control

Contrôle auquel s'applique la touche de commande.

Retours

Boolean

true si le caractère a été traité par le contrôle ; sinon false.

Remarques

Cette méthode est appelée pendant le prétraitement des messages pour gérer les clés de commande. Les clés de commande sont des clés qui sont toujours prioritaires sur les clés d’entrée standard. Parmi les exemples de touches de commande, citons les accélérateurs et les raccourcis de menu. La méthode doit revenir true pour indiquer qu’elle a traité la clé de commande ou false pour indiquer que la clé n’est pas une clé de commande. Cette méthode est appelée uniquement lorsque le contrôle est hébergé dans une application Windows Forms ou en tant que contrôle ActiveX.

La ProcessCmdKey méthode détermine d’abord si le contrôle a un ContextMenuet, si c’est le cas, permet de ContextMenu traiter la clé de commande. Si la touche de commande n’est pas un raccourci de menu et que le contrôle a un parent, la clé est passée à la méthode du ProcessCmdKey parent. L’effet net est que les clés de commande sont « bulles » dans la hiérarchie de contrôle. En plus de la touche enfoncée par l’utilisateur, les données de touche indiquent également quelles touches de modificateurs ont été enfoncées en même temps que la touche. Les touches modificateurs incluent les touches Maj, Ctrl et Alt.

Notes pour les héritiers

Lors de la substitution de la ProcessCmdKey(Message, Keys) méthode dans une classe dérivée, un contrôle doit revenir true pour indiquer qu’il a traité la clé. Pour les clés qui ne sont pas traitées par le contrôle, le résultat de l’appel de la méthode de la classe de ProcessCmdKey(Message, Keys) base doit être retourné. Les contrôles doivent rarement, voire jamais, remplacer cette méthode.