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


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.

Legacy Code Example

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.
[SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public class TestMessageFilter : IMessageFilter
    public bool PreFilterMessage(ref Message m)
        // Blocks all the messages relating to the left mouse button.
        if (m.Msg >= 513 && m.Msg <= 515)
            Console.WriteLine("Processing the messages : " + m.Msg);
            return true;
        return false;

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