Control.ProcessKeyPreview(Message) Méthode

Définition

Affiche un aperçu d'un message du clavier.Previews a keyboard message.

protected:
 virtual bool ProcessKeyPreview(System::Windows::Forms::Message % m);
protected virtual bool ProcessKeyPreview (ref System.Windows.Forms.Message m);
abstract member ProcessKeyPreview : Message -> bool
override this.ProcessKeyPreview : Message -> bool
Protected Overridable Function ProcessKeyPreview (ByRef m As Message) As Boolean

Paramètres

m
Message

Message, passé par référence, qui représente le message de fenêtre à traiter.A Message, passed by reference, that represents the window message to process.

Retours

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

Remarques

Cette méthode est appelée par un contrôle enfant lorsque le contrôle enfant reçoit un message de clavier.This method is called by a child control when the child control receives a keyboard message. Le contrôle enfant appelle cette méthode avant de générer des événements de clavier pour le message.The child control calls this method before generating any keyboard events for the message. Si cette méthode retourne true, le contrôle enfant considère que le message est traité et ne génère pas d’événements de clavier.If this method returns true, the child control considers the message processed and does not generate any keyboard events. Le paramètre m contient le message de fenêtre à prévisualiser.The m parameter contains the window message to preview. Les valeurs possibles pour la propriété Message.Msg sont WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP et WM_SYSKEYUP.Possible values for the Message.Msg property are WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP, and WM_SYSKEYUP. La méthode ProcessKeyPreview envoie simplement le caractère à la méthode ProcessKeyPreview du parent, ou retourne false si le contrôle n’a pas de parent.The ProcessKeyPreview method simply sends the character to the parent's ProcessKeyPreview 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.

Notes pour les héritiers

Lors de la substitution de la méthode ProcessKeyPreview(Message) dans une classe dérivée, un contrôle doit retourner true pour indiquer qu’il a traité la clé.When overriding the ProcessKeyPreview(Message) 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 ProcessKeyPreview(Message) 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 ProcessKeyPreview(Message) method should be returned.

Sécurité

UIPermission
pour toutes les fenêtres permettant d’hériter des classes pour appeler cette méthode.for all windows for inheriting classes to call this method. Énumération associée : valeur AllWindows de UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

SecurityPermission
pour que l’appelant immédiat appelle du code non managé.for the immediate caller to call unmanaged code. Énumération associée : UnmanagedCodeAssociated enumeration: UnmanagedCode

S’applique à

Voir aussi