Vcl.Dialogs.TCommonDialog.MessageHook
Delphi
function MessageHook(var Msg: TMessage): Boolean; virtual;
C++
virtual bool __fastcall MessageHook(Winapi::Messages::TMessage &Msg);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | protected | Vcl.Dialogs.pas Vcl.Dialogs.hpp |
Vcl.Dialogs | TCommonDialog |
説明
ダイアログの特殊なウィンドウメッセージ処理を提供します。
ダイアログのウィンドウプロシージャがダイアログウィンドウへのメッセージを取得する前に,MessageHook メソッドはそうしたメッセージを代行受信します。MessageHook メソッドはメッセージを処理すると true を返し,それ以上の処理を行うための転送が不要なことを示します。ウィンドウプロシージャによるメッセージ処理が必要な場合は,MessageHook メソッドは false を返します。
MessageHook メソッドをオーバーライドすると,追加のメッセージ処理を提供できます。たとえば,Template プロパティがダイアログテンプレートを追加のコントロールに替えた場合,MessageHook メソッドを使ってそうしたダイアログコントロールからのメッセージを処理できます。
TCommonDialog では,HelpContext プロパティが定義されている場合,MessageHook メソッドはアプリケーションの HelpContext メソッドを呼び出すことでヘルプメッセージを処理します。TCommonDialog の下位オブジェクトは,MessageHook メソッドをオーバーライドして補足的なメッセージ処理を追加します。