LPPAGESETUPHOOK

Page Setup ダイアログボックスの既定のダイアログボックスプロシージャに送られるメッセージや通知を受け取ります。PageSetupHook フックプロシージャは、PageSetupDlg 関数と共に使用される、アプリケーション定義またはライブラリ定義のコールバック関数です。

LPPAGESETUPHOOK 型は、このコールバック関数へのポインターを定義します。PageSetupHook は、アプリケーション定義またはライブラリ定義の関数名のプレースホルダーです。

フックプロシージャが 0 を返した場合、既定のダイアログボックスプロシージャがそのメッセージを処理します。

フックプロシージャが 0 以外の値を返した場合、既定のダイアログボックスプロシージャはそのメッセージを無視します。

PageSetupDlg 関数を使用して Page Setup ダイアログボックスを作成する場合、ダイアログボックスプロシージャに送られるメッセージや通知を処理する PageSetupHook フックプロシージャを用意できます。フックプロシージャを有効にするには、ダイアログ作成関数に渡した PAGESETUPDLG 構造体を使用します。lpfnPageSetupHook メンバーにフックプロシージャへのポインターを指定し、Flags メンバーに PSD_ENABLEPAGESETUPHOOK フラグを指定します。

既定のダイアログボックスプロシージャは、WM_INITDIALOG メッセージをフックプロシージャに渡す前に処理します。それ以外のすべてのメッセージについては、フックプロシージャが先にメッセージを受け取ります。その後、フックプロシージャの戻り値によって、既定のダイアログプロシージャがそのメッセージを処理するか無視するかが決まります。

フックプロシージャが WM_CTLCOLORDLG メッセージを処理する場合は、ダイアログボックスの背景を描画するための有効なブラシハンドルを返す必要があります。一般に、フックプロシージャが WM_CTLCOLOR* メッセージを処理する場合は、指定されたコントロールの背景を描画するための有効なブラシハンドルを返す必要があります。

フックプロシージャから EndDialog 関数を呼び出さないでください。代わりに、フックプロシージャは PostMessage 関数を呼び出して、IDABORT 値を伴う WM_COMMAND メッセージをダイアログボックスプロシージャにポストできます。IDABORT をポストするとダイアログボックスが閉じられ、ダイアログボックス関数は FALSE を返します。フックプロシージャがダイアログボックスを閉じた理由を知る必要がある場合は、フックプロシージャとアプリケーションとの間の通信手段を独自に用意する必要があります。

コモンダイアログボックスの標準コントロールはサブクラス化できます。ただし、ダイアログボックスプロシージャもコントロールをサブクラス化することがあります。そのため、コントロールのサブクラス化は、フックプロシージャが WM_INITDIALOG メッセージを処理するときに行ってください。これにより、ダイアログボックスプロシージャが設定したサブクラスプロシージャよりも先に、自分のサブクラスプロシージャがコントロール固有のメッセージを受け取るようになります。