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)

public:
static void RemoveMessageFilter(
	IMessageFilter^ value
)

Parameters

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
{
public:
   [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
Show:
© 2016 Microsoft