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