IMessageFilter.PreFilterMessage メソッド

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

IMessageFilter.PreFilterMessage メソッド

メッセージがディスパッチされる前に、フィルタで排除します。

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

Visual Basic (宣言)

Function PreFilterMessage ( _
    ByRef m As Message _
) As Boolean

Visual Basic (使用法)

Dim instance As IMessageFilter
Dim m As Message
Dim returnValue As Boolean

returnValue = instance.PreFilterMessage(m)

C#

bool PreFilterMessage (
    ref Message m
)

C++

bool PreFilterMessage (
    Message% m
)

J#

boolean PreFilterMessage (
    /** @ref */ Message m
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

m

ディスパッチされるメッセージ。このメッセージは変更できません。

戻り値
true の場合、メッセージはフィルタで排除され、ディスパッチされません。false の場合、メッセージは次のフィルタまたはコントロールに継続されます。

解説

コントロールまたはフォームにディスパッチされる前に、メッセージをフィルタで排除するには、PreFilterMessage を使用します。たとえば、Button コントロールの Click イベントをコントロールにディスパッチされないようにするには、PreFilterMessage メソッドを実装し、Click メッセージが発生したら true 値を返します。また、このメソッドを使用すると、メッセージがディスパッチされる前に行う必要のあるコード作業も実行できます。

.NET Framework のセキュリティ

• SecurityPermission  リンク時に 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

参照

関連項目
IMessageFilter インターフェイス
IMessageFilter メンバ
System.Windows.Forms 名前空間