LPCFHOOKPROC
コールバックシグネチャ
UINT_PTR LPCFHOOKPROC(
HWND param0,
DWORD param1,
WPARAM param2,
LPARAM param3
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| param0 | HWND | メッセージの宛先である Font ダイアログボックスへのハンドル。 |
| param1 | DWORD | 受け取るメッセージの識別子。 |
| param2 | WPARAM | メッセージに関する追加情報。正確な意味は unnamedParam2 パラメーターの値によって異なります。 |
| param3 | LPARAM | メッセージに関する追加情報。正確な意味は unnamedParam2 パラメーターの値によって異なります。unnamedParam2 パラメーターが WM_INITDIALOG メッセージを示している場合、unnamedParam4 は、ダイアログボックスの作成時に指定された値を格納した CHOOSEFONT 構造体へのポインターです。 |
公式ドキュメント
Font ダイアログボックスの既定のダイアログボックスプロシージャ宛てのメッセージや通知を受け取ります。これは ChooseFont 関数と共に使用される、アプリケーション定義またはライブラリ定義のコールバックプロシージャです。
LPCFHOOKPROC 型は、このコールバック関数へのポインターを定義します。CFHookProc は、アプリケーション定義の関数名を表すプレースホルダーです。
戻り値
フックプロシージャが 0 を返した場合、既定のダイアログボックスプロシージャがそのメッセージを処理します。
フックプロシージャが 0 以外の値を返した場合、既定のダイアログボックスプロシージャはそのメッセージを無視します。
解説(Remarks)
ChooseFont 関数で Font ダイアログボックスを作成する場合、ダイアログボックスプロシージャ宛てのメッセージや通知を処理する CFHookProc フックプロシージャを用意できます。フックプロシージャを有効にするには、ダイアログボックス作成関数に渡す CHOOSEFONT 構造体を使用します。lpfnHook メンバーにフックプロシージャのアドレスを指定し、Flags メンバーに CF_ENABLEHOOK フラグを指定してください。
既定のダイアログボックスプロシージャは、WM_INITDIALOG メッセージをフックプロシージャに渡す前に処理します。それ以外のすべてのメッセージについては、フックプロシージャが先にメッセージを受け取ります。既定のダイアログボックスプロシージャがそのメッセージを処理するか無視するかは、フックプロシージャの戻り値によって決まります。
フックプロシージャが WM_CTLCOLORDLG メッセージを処理する場合は、ダイアログボックスの背景を描画するための有効なブラシハンドルを返す必要があります。一般に、フックプロシージャが WM_CTLCOLOR* メッセージを処理する場合は、指定されたコントロールの背景を描画するための有効なブラシハンドルを返す必要があります。
フックプロシージャから EndDialog 関数を呼び出さないでください。代わりに、フックプロシージャは PostMessage 関数を使用して、IDABORT 値を伴う WM_COMMAND メッセージをダイアログボックスプロシージャにポストできます。IDABORT をポストするとダイアログボックスが閉じ、ダイアログボックス関数は FALSE を返します。フックプロシージャがダイアログボックスを閉じた理由を知る必要がある場合は、フックプロシージャとアプリケーションとの間の通信手段を独自に用意する必要があります。
コモンダイアログボックスの標準コントロールはサブクラス化できます。ただし、ダイアログボックスプロシージャもコントロールをサブクラス化することがあります。そのため、コントロールのサブクラス化は、フックプロシージャが WM_INITDIALOG メッセージを処理するときに行ってください。こうすることで、ダイアログボックスプロシージャが設定したサブクラスプロシージャよりも先に、独自のサブクラスプロシージャがコントロール固有のメッセージを受け取れるようになります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)