Application.AddMessageFilter メソッド

.NET Framework クラス ライブラリ リファレンス

Application.AddMessageFilter メソッド

メッセージ フィルタを追加して、ルーティング先にルーティングされる Windows メッセージを監視します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub AddMessageFilter
 ( _
    value As IMessageFilter _
)

Visual Basic (使用法)

Dim value As IMessageFilter

Application.AddMessageFilter(value)

C#

public static void AddMessageFilter
 (
    IMessageFilter value
)

C++

public:
static void AddMessageFilter (
    IMessageFilter^ value
)

J#

public static void AddMessageFilter
 (
    IMessageFilter value
)

JScript

public static function AddMessageFilter
 (
    value : IMessageFilter
)

パラメータ

value

インストールする IMessageFilter インターフェイスの実装。

解説

メッセージ フィルタを使用して、メッセージがイベント ハンドラに渡される前に、特定のイベントの発生を回避したり、イベントに特別な操作を実行したりします。メッセージ フィルタはスレッドに固有です。

メッセージをディスパッチされないようにするには、このメソッドに渡す value パラメータ インスタンスで、メッセージの処理コードを持つ PreFilterMessage メソッドをオーバーライドする必要があります。このメソッドは false を返します。

注意
アプリケーションのメッセージ ポンプにメッセージ フィルタを追加すると、パフォーマンスを低下させる場合があります。

使用例

TestMessageFilter というメッセージ フィルタを作成するコード例を次に示します。このフィルタは、マウスの左ボタンに関連するメッセージをすべてブロックします。メッセージ フィルタは、IMessageFilter インターフェイスを実装してからでなければ使用できません。

J#

// Creates a  message filter.
public class TestMessageFilter implements IMessageFilter
{
    /** @attribute SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)
     */
    public boolean PreFilterMessage(
        /**@ref
         */
        Message m)
    {
        // Blocks all the messages relating to the left mouse button.
        if (m.get_Msg() >= 513 && m.get_Msg() <=
 515) {
            Console.WriteLine("Processing the messages : " + m.get_Msg());
            return true;
        }
        return false;
    } //PreFilterMessage
} //TestMessageFilter

.NET Framework のセキュリティ

• SecurityPermission  (直前の呼び出し元がアンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Application クラス
Application メンバ
System.Windows.Forms 名前空間