Control.ProcessKeyPreview(Message) Methode

Definition

Zeigt eine Tastaturmeldung in der Vorschau an.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

Parameter

m
Message

Eine als Verweis übergebene Message, die die zu verarbeitende Fenstermeldung darstellt.A Message, passed by reference, that represents the window message to process.

Gibt zurück

true, wenn die Meldung vom Steuerelement verarbeitet wurde, andernfalls false.true if the message was processed by the control; otherwise, false.

Hinweise

Diese Methode wird von einem untergeordneten Steuerelement aufgerufen, wenn das untergeordnete Steuerelement eine Tastatur Meldung empfängt.This method is called by a child control when the child control receives a keyboard message. Das untergeordnete Steuerelement ruft diese Methode auf, bevor Tastatur Ereignisse für die Nachricht erzeugt werden.The child control calls this method before generating any keyboard events for the message. Wenn diese Methode true zurückgibt, betrachtet das untergeordnete Steuerelement die verarbeitete Nachricht und generiert keine Tastatur Ereignisse.If this method returns true, the child control considers the message processed and does not generate any keyboard events. Der m-Parameter enthält die Fenster Meldung, die in der Vorschau angezeigt wird.The m parameter contains the window message to preview. Mögliche Werte für die Message.Msg-Eigenschaft sind WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP und WM_SYSKEYUP.Possible values for the Message.Msg property are WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP, and WM_SYSKEYUP. Die ProcessKeyPreview-Methode sendet das Zeichen einfach an die ProcessKeyPreview-Methode des übergeordneten Elements oder gibt false zurück, wenn das Steuerelement über kein übergeordnetes Element verfügt.The ProcessKeyPreview method simply sends the character to the parent's ProcessKeyPreview method, or returns false if the control has no parent. Die Form-Klasse überschreibt diese Methode, um die tatsächliche Verarbeitung von Dialog Schlüsseln auszuführen.The Form class overrides this method to perform actual processing of dialog keys.

Hinweise für Vererber

Wenn die ProcessKeyPreview(Message)-Methode in einer abgeleiteten Klasse überschrieben wird, sollte ein Steuerelement true zurückgeben, um anzugeben, dass es den Schlüssel verarbeitet hat.When overriding the ProcessKeyPreview(Message) method in a derived class, a control should return true to indicate that it has processed the key. Bei Schlüsseln, die nicht vom Steuerelement verarbeitet werden, sollte das Ergebnis des Aufrufs der ProcessKeyPreview(Message)-Methode der Basisklasse zurückgegeben werden.For keys that are not processed by the control, the result of calling the base class's ProcessKeyPreview(Message) method should be returned.

Sicherheit

UIPermission
für alle Fenster für erbende Klassen, um diese Methode aufzurufen.for all windows for inheriting classes to call this method. Zugeordnete Enumeration: AllWindows-Wert UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

SecurityPermission
für den unmittelbaren Aufrufer zum Aufruf von nicht verwaltetem Code.for the immediate caller to call unmanaged code. Zugehörige Enumeration: UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für:

Siehe auch