Control.ProcessCmdKey(Message, Keys) Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Traite une touche 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

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.

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 par rapport aux clés d’entrée régulières. Par exemple, les touches de commande incluent des accélérateurs et des 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 « 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 modificateur 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 retourner 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 ProcessCmdKey(Message, Keys) la classe de base doit être retourné. Les contrôles n’auront jamais besoin de remplacer cette méthode.

S’applique à