Control.ProcessKeyPreview(Message) Control.ProcessKeyPreview(Message) Control.ProcessKeyPreview(Message) Control.ProcessKeyPreview(Message) Method

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 :  -> bool
override this.ProcessKeyPreview :  -> bool
Protected Overridable Function ProcessKeyPreview (ByRef m As Message) As Boolean

Paramètres

m
Message Message Message 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 les é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 de traitement 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 m paramètre contient le message de fenêtre pour afficher un aperçu.The m parameter contains the window message to preview. Les valeurs possibles pour le Message.Msg propriété 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. Le ProcessKeyPreview méthode envoie simplement le caractère à du parent ProcessKeyPreview (méthode), ou retourne false si le contrôle n’a aucun parent.The ProcessKeyPreview method simply sends the character to the parent's ProcessKeyPreview method, or returns false if the control has no parent. Le Form classe substitue cette méthode pour effectuer le traitement réel des clés de la boîte de dialogue.The Form class overrides this method to perform actual processing of dialog keys.

Notes pour les héritiers

Lors du remplacement de la ProcessKeyPreview(Message) méthode 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és par le contrôle, le résultat de l’appel de la classe de base ProcessKeyPreview(Message) méthode doit être retournée.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 pour hériter de classes pour appeler cette méthode.for all windows for inheriting classes to call this method. Énumération associée : AllWindows valeur UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

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

S’applique à

Voir aussi