Freigeben über

Control.PreProcessMessage-Methode

  • Artikel

Führt eine Vorverarbeitung der Tastatur- oder Eingabemeldungen in der Meldungsschleife aus, bevor sie gesendet werden.

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

Syntax

'Declaration
Public Overridable Function PreProcessMessage ( _
    ByRef msg As Message _
) As Boolean
'Usage
Dim instance As Control
Dim msg As Message
Dim returnValue As Boolean

returnValue = instance.PreProcessMessage(msg)

public virtual bool PreProcessMessage (
    ref Message msg
)

public:
virtual bool PreProcessMessage (
    Message% msg
)

public boolean PreProcessMessage (
    /** @ref */ Message msg
)

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

Parameter

  • msg
    Eine als Verweis übergebene Message, die die zu verarbeitende Meldung darstellt. Die möglichen Werte sind WM_KEYDOWN, WM_SYSKEYDOWN, WM_CHAR und WM_SYSCHAR.

Rückgabewert

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

Hinweise

PreProcessMessage wird von der Meldungsschleife der Anwendung aufgerufen, um Eingabemeldungen vor dem Verteilen zu bearbeiten. Mögliche Werte für die msg-Parameter sind WM_KEYDOWN, WM_SYSKEYDOWN, WM_CHAR und WM_SYSCHAR.

Beim Überschreiben von PreProcessMessage muss ein Steuerelement true zurückgeben, um anzugeben, dass es die Meldung verarbeitet hat. Für Meldungen, die nicht durch das Steuerelement verarbeitet werden, muss das Ergebnis von base.PreProcessMessage zurückgegeben werden. Steuerelemente überschreiben i. d. R. eine der spezifischen Methoden, z. B. IsInputChar, IsInputKey, ProcessCmdKey, ProcessDialogChar oder ProcessDialogKey, statt PreProcessMessage zu überschreiben.

.NET Framework-Sicherheit

  • UIPermission  für alle Fenster für erbende Klassen zum Aufrufen dieser Methode. Zugeordnete Enumeration: AllWindows-Wert von UIPermissionWindow.
  • UIPermission  für alle Fenster, um diese Methode durch den unmittelbaren Aufrufer aufzurufen. Zugeordnete Enumeration: AllWindows-Wert von UIPermissionWindow.

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