Vcl.AppEvnts.TCustomApplicationEvents.OnMessage
Delphi
property OnMessage: TMessageEvent read FOnMessage write FOnMessage;
C++
__property Vcl::Forms::TMessageEvent OnMessage = {read=FOnMessage, write=FOnMessage};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| event | protected | Vcl.AppEvnts.pas Vcl.AppEvnts.hpp |
Vcl.AppEvnts | TCustomApplicationEvents |
説明
アプリケーションが Windows メッセージを受信したときに発生します。
OnMessage イベントを使用すると，アプリケーションのすべてのウィンドウに送られるすべての Windows メッセージをトラップできます。OnMessage は，アプリケーションが Windows メッセージを受け取ったときに発生します。OnMessage WaitMessage はメッセージキューに送られたメッセージだけを受け取り，Windows API の SendMessage 関数によって直接送られたメッセージは受け取りません。
OnMessage イベントハンドラを使用すると，アプリケーションは，TApplication のイベントで宣言されたメッセージ以外のメッセージに応答できます。送られたメッセージに対する特定のハンドラがアプリケーションにない場合，メッセージは送り先のウィンドウにディスパッチされ，Windows がそのメッセージを処理します。
警告： 注意：1 秒間に数千のメッセージがこのイベントを通過します。アプリケーション全体のパフォーマンスに影響を与える恐れがあるため，ハンドラのコーディングには注意してください。
ヒント： CancelDispatch メソッドを OnMessage イベントハンドラから呼び出すと，アプリケーションがほかのアプリケーションイベントオブジェクトにイベントを転送しないようにできます。