Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Control.ProcessCmdKey méthode (Message, Keys)

 

Date de publication : novembre 2016

Traite une touche de commande.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, 
	Flags = SecurityPermissionFlag.UnmanagedCode)]
protected virtual bool ProcessCmdKey(
	ref Message msg,
	Keys keyData
)

Paramètres

msg
Type: System.Windows.Forms.Message

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

keyData
Type: System.Windows.Forms.Keys

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

Valeur de retour

Type: System.Boolean

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

Cette méthode est appelée pendant le prétraitement du message pour gérer les touches de commande. Touches de commande sont des clés qui ont toujours priorité sur les touches d’entrée régulières. Accélérateurs et les raccourcis de menu sont des exemples de touches de commande. La méthode doit retourner true pour indiquer qu’il a traité la touche de commande, ou false pour indiquer que la clé n’est pas une touche de commande. Cette méthode est appelée uniquement lorsque le contrôle est hébergé dans une application Windows Forms ou comme un contrôle ActiveX.

Le ProcessCmdKey méthode détermine d’abord si le contrôle a une ContextMenu, et si tel est le cas, permet la ContextMenu pour traiter la touche de commande. Si la touche de commande n’est pas un raccourci de menu et le contrôle a un parent, la touche est passée à du parent ProcessCmdKey méthode. L’effet net est que les clés sont « propagée dans « la hiérarchie des contrôles de commande. En plus de la touche de l’utilisateur, les données de clé indiquent également qui, le cas échéant, les touches de modification ont été enfoncées en même temps que la clé. Touches de modification incluent les touches MAJ, CTRL et ALT.

Remarques à l’attention des héritiers :

Lors de la substitution du ProcessCmdKey méthode dans une classe dérivée, un contrôle doit retourner true pour indiquer qu’il a traité la touche. Pour les clés qui ne sont pas traités par le contrôle, le résultat de l’appel de la classe de base ProcessCmdKey méthode doit être retournée. Contrôles rarement, voire jamais, devez substituer cette méthode.

SecurityPermission

for the immediate caller and inheriting classes to call this method. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode.

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: