Control.PreProcessMessage メソッド

入力メッセージがディスパッチされる前に、メッセージ ループ内の入力メッセージをプリプロセスします。

Public Overridable Function PreProcessMessage( _
   ByRef msg As Message _) As Boolean
[C#]
public virtual bool PreProcessMessage(   ref Messagemsg);
[C++]
public: virtual bool PreProcessMessage(Message* msg);
[JScript]
public function PreProcessMessage(
   msg : Message) : Boolean;

パラメータ

  • msg
    処理するメッセージを表す、参照渡しされた Message

戻り値

メッセージがコントロールによって処理された場合は true 。それ以外の場合は false

解説

PreProcessMessage は、入力メッセージのプリプロセスを実行してからディスパッチするために、アプリケーションのメッセージ ループから呼び出されます。msg.message フィールドで有効な値は、WM_KEYDOWN、WM_SYSKEYDOWN、WM_CHAR、および WM_SYSCHAR です。

preProcessMessage() をオーバーライドすると、コントロールはメッセージを処理したことを示すために true を返します。コントロールで処理されないメッセージについては、 base.preProcessMessage() の結果が返されます。通常、 preProcessMessage() ではなく、 isInputChar()isInputKey()processCmdKey()processDialogChar()processDialogKey() などの、より特化されたメソッドのいずれかがコントロールによってオーバーライドされます。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間