Application.AddMessageFilter(IMessageFilter) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

加入訊息篩選器，以在 Windows 訊息被傳送到它們的目的地時加以監視。

public:
 static void AddMessageFilter(System::Windows::Forms::IMessageFilter ^ value);

public static void AddMessageFilter (System.Windows.Forms.IMessageFilter? value);

static member AddMessageFilter : System.Windows.Forms.IMessageFilter -> unit

Public Shared Sub AddMessageFilter (value As IMessageFilter)

參數

value

IMessageFilter

您想要安裝的 IMessageFilter 介面實作。

範例

下列程式碼範例會建立名為 的 TestMessageFilter 訊息篩選。 此篩選會封鎖與滑鼠左鍵相關的所有訊息。 您必須先提供 介面的 IMessageFilter 實作，才能使用訊息篩選。

// 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;
   }

};

// Creates a  message filter.
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;
    }
}

' Creates a message filter.
<SecurityPermission(SecurityAction.LinkDemand, Flags := SecurityPermissionFlag.UnmanagedCode)> _
Public Class TestMessageFilter
    Implements IMessageFilter

    <SecurityPermission(SecurityAction.Demand)> _
    Public Function PreFilterMessage(ByRef m As System.Windows.Forms.Message) _
    As Boolean Implements IMessageFilter.PreFilterMessage
        ' Blocks all the messages relating to the left mouse button.
        If ((m.Msg >= 513) And (m.Msg <= 515)) Then
            Console.WriteLine("Processing the messages : " & m.Msg)
            Return True
        End If
        Return False
    End Function
End Class

備註

使用訊息篩選來防止引發特定事件，或在事件傳遞至事件處理常式之前執行事件的特殊作業。 訊息篩選準則對特定執行緒而言是唯一的。

為了避免分派訊息， value 您傳遞至這個方法的參數實例必須使用程式碼覆寫 PreFilterMessage 方法來處理訊息。 此方法必須傳回 false。

警告

將訊息篩選新增至應用程式的訊息幫浦可能會降低效能。