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