Vcl.Dialogs.TCommonDialog.MessageHook

提供: RAD Studio API Documentation
移動先: 案内検索

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 メソッドをオーバーライドして補足的なメッセージ処理を追加します。

関連項目