Control.ProcessKeyPreview-Methode

Artikel
08/20/2007

Zeigt eine Tastaturmeldung in der Vorschau an.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Protected Overridable Function ProcessKeyPreview ( _
    ByRef m As Message _
) As Boolean
'Usage
Dim m As Message
Dim returnValue As Boolean

returnValue = Me.ProcessKeyPreview(m)

protected virtual bool ProcessKeyPreview (
    ref Message m
)

protected:
virtual bool ProcessKeyPreview (
    Message% m
)

protected boolean ProcessKeyPreview (
    /** @ref */ Message m
)

JScript unterstützt die Übergabe von Werttypargumenten als Verweis nicht.

Parameter

m
Eine als Verweis übergebene Message, die die zu verarbeitende Fenstermeldung darstellt.

Rückgabewert

true, wenn die Meldung vom Steuerelement verarbeitet wurde, andernfalls false.

Hinweise

Diese Methode wird von einem untergeordneten Steuerelement aufgerufen, wenn dieses eine Tastaturmeldung erhält. Das untergeordnete Steuerelement ruft diese Methode vor dem Generieren von Tastaturereignissen für die Meldung auf. Wenn diese Methode true zurückgibt, betrachtet das untergeordnete Steuerelement die Meldung als verarbeitet und generiert keine Tastaturereignisse. Der m-Parameter enthält die Fenstermeldung, deren Vorschau angezeigt werden soll. Mögliche Werte für die Message.Msg-Eigenschaft sind WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP und WM_SYSKEYUP. Die ProcessKeyPreview-Methode sendet das Zeichen einfach zu der ProcessKeyPreview-Methode des übergeordneten Elements oder gibt false zurück, wenn kein übergeordnetes Element für das Steuerelement vorhanden ist. Die Form-Klasse überschreibt diese Methode, um die Tastatureingaben im Dialogfeld tatsächlich zu verarbeiten.

Hinweise für Erben Beim Überschreiben der ProcessKeyPreview-Methode in einer abgeleiteten Klasse zeigt ein Steuerelement durch die Rückgabe von true an, dass die Taste verarbeitet wurde. Für vom Steuerelement nicht verarbeitete Tasten wird das Ergebnis des Aufrufs der ProcessKeyEventArgs-Methode der Basisklasse zurückgegeben.

.NET Framework-Sicherheit

UIPermission für alle Fenster für erbende Klassen zum Aufrufen dieser Methode. Zugeordnete Enumeration: AllWindows-Wert von UIPermissionWindow.
SecurityPermission für den Aufruf von nicht verwaltetem Code durch den unmittelbaren Aufrufer. Zugeordnete Enumeration: UnmanagedCode

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
KeyPress
KeyDown
KeyUp

Freigeben über