Control.ProcessCmdKey(Message, Keys) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Traite une clé de commande.

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

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

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

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

Paramètres

msg

Message

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

keyData

Keys

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

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 régulières. Parmi les exemples de touches de commande, citons les raccourcis de menu 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 ContextMenucontrôle, et le cas échéant, 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 « en 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 modificateur ont été enfoncées en même temps que la touche. Les touches de modification incluent les touches Maj, Ctrl et Alt.

Notes pour les héritiers

En cas de 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 devront rarement, si jamais, remplacer cette méthode.