Freigeben über


IMessageFilter.PreFilterMessage-Methode

Filtert eine Meldung, bevor sie gesendet wird.

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

Syntax

'Declaration
Function PreFilterMessage ( _
    ByRef m As Message _
) As Boolean
'Usage
Dim instance As IMessageFilter
Dim m As Message
Dim returnValue As Boolean

returnValue = instance.PreFilterMessage(m)
bool PreFilterMessage (
    ref Message m
)
bool PreFilterMessage (
    Message% m
)
boolean PreFilterMessage (
    /** @ref */ Message m
)
JScript unterstützt die Übergabe von Werttypargumenten als Verweis nicht.

Parameter

  • m
    Die zu sendende Meldung. Diese Meldung kann nicht geändert werden.

Rückgabewert

true, um die Meldung zu filtern und das Senden zu verhindern. false, um das Senden der Meldung bis zum nächsten Filter oder Steuerelement zu ermöglichen.

Hinweise

Mit PreFilterMessage, können Sie eine Meldung filtern, bevor sie an ein Steuerelement oder Formular gesendet wird. Um z. B. zu verhindern, dass das Click-Ereignis eines Button-Steuerelements an das Steuerelement gesendet wird, implementieren Sie die PreFilterMessage-Methode, und geben Sie einen true-Wert zurück, wenn die Click-Meldung angezeigt wird. Bei Bedarf können Sie mit dieser Methode auch Code bearbeiten, bevor die Meldung gesendet wird.

.NET Framework-Sicherheit

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

IMessageFilter-Schnittstelle
IMessageFilter-Member
System.Windows.Forms-Namespace