Control.ProcessDialogKey(Keys) Method

Definition

Traite une touche de boîte de dialogue.Processes a dialog key.

protected:
 virtual bool ProcessDialogKey(System::Windows::Forms::Keys keyData);
protected virtual bool ProcessDialogKey (System.Windows.Forms.Keys keyData);
abstract member ProcessDialogKey : System.Windows.Forms.Keys -> bool
override this.ProcessDialogKey : System.Windows.Forms.Keys -> bool
Protected Overridable Function ProcessDialogKey (keyData As Keys) As Boolean

Parameters

keyData
Keys

Une des valeurs Keys qui représente la touche à traiter.One of the Keys values that represents the key to process.

Returns

Boolean

true si la touche a été traitée par le contrôle ; sinon, false.true if the key was processed by the control; otherwise, false.

Remarks

Cette méthode est appelée pendant le prétraitement des messages pour gérer les caractères de boîte de dialogue, tels que les touches TAB, retour, ÉCHAP et les touches de direction.This method is called during message preprocessing to handle dialog characters, such as TAB, RETURN, ESC, and arrow keys. Cette méthode est appelée uniquement si la méthode IsInputKey indique que le contrôle ne traite pas la clé.This method is called only if the IsInputKey method indicates that the control is not processing the key. La ProcessDialogKey envoie simplement le caractère à la méthode ProcessDialogKey du parent, ou retourne false si le contrôle n’a pas de parent.The ProcessDialogKey simply sends the character to the parent's ProcessDialogKey method, or returns false if the control has no parent. La classe Form remplace cette méthode pour effectuer le traitement réel des touches de dialogue.The Form class overrides this method to perform actual processing of dialog keys. 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.This method is only called when the control is hosted in a Windows Forms application or as an ActiveX control.

Notes to Inheritors

Lors de la substitution de la méthode ProcessDialogKey(Keys) dans une classe dérivée, un contrôle doit retourner true pour indiquer qu’il a traité la clé.When overriding the ProcessDialogKey(Keys) method in a derived class, a control should return true to indicate that it has processed the key. Pour les clés qui ne sont pas traitées par le contrôle, le résultat de l’appel de la méthode ProcessDialogChar(Char) de la classe de base doit être retourné.For keys that are not processed by the control, the result of calling the base class's ProcessDialogChar(Char) method should be returned. Les contrôles auront rarement besoin de substituer cette méthode.Controls will seldom, if ever, need to override this method.

Applies to