RemoveMessageFilter Method

Application::RemoveMessageFilter Method (IMessageFilter^)


Removes a message filter from the message pump of the application.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

static void RemoveMessageFilter(
	IMessageFilter^ value


Type: System.Windows.Forms::IMessageFilter^

The implementation of the IMessageFilter to remove from the application.

You can remove a message filter when you no longer want to capture Windows messages before they are dispatched.

Before you can use a message filter, you must provide an implementation for the IMessageFilter interface. The following class creates a message filter called TestMessageFilter. This filter blocks all messages relating to the left mouse button.

// Creates a  message filter.
ref class TestMessageFilter: public IMessageFilter
   [SecurityPermission(SecurityAction::LinkDemand, Flags = SecurityPermissionFlag::UnmanagedCode)]
   virtual bool PreFilterMessage( Message % m )

      // Blocks all the messages relating to the left mouse button.
      if ( m.Msg >= 513 && m.Msg <= 515 )
         Console::WriteLine( "Processing the messages : {0}", m.Msg );
         return true;

      return false;


.NET Framework
Available since 1.1
Return to top
© 2016 Microsoft