IMessageFilter.PreFilterMessage(Message) メソッド

定義

メッセージがディスパッチされる前に、フィルターで排除します。Filters out a message before it is dispatched.

public:
 bool PreFilterMessage(System::Windows::Forms::Message % m);
public bool PreFilterMessage (ref System.Windows.Forms.Message m);
abstract member PreFilterMessage : Message -> bool
Public Function PreFilterMessage (ByRef m As Message) As Boolean

パラメーター

m
Message

ディスパッチされるメッセージ。The message to be dispatched. このメッセージは変更できません。You cannot modify this message.

戻り値

true の場合、メッセージはフィルターで排除され、ディスパッチされません。false の場合、メッセージは次のフィルターまたはコントロールに継続されます。true to filter the message and stop it from being dispatched; false to allow the message to continue to the next filter or control.

注釈

コントロールPreFilterMessageまたはフォームにディスパッチされる前に、を使用してメッセージをフィルターで除外します。Use PreFilterMessage to filter out a message before it is dispatched to a control or form. たとえば、コントロールに対してClick Buttonコントロールがディスパッチされるのを防ぐには、 PreFilterMessageメソッドを実装し、 Clickメッセージがtrue発生したときに値を返します。For example, to stop the Click event of a Button control from being dispatched to the control, you implement the PreFilterMessage method and return a true value when the Click message occurs. また、このメソッドを使用して、メッセージがディスパッチされる前に実行する必要のあるコード作業を実行することもできます。You can also use this method to perform code work that you might need to do before the message is dispatched.

セキュリティ

SecurityPermission
リンクUnmanagedCode時にアクセス許可が必要です。Requires UnmanagedCode permission at link time.

適用対象