LPPAGEPAINTHOOK 回呼函式 (commdlg.h)

接收訊息，可讓您在 [ 版面設定 ] 對話框中自定義範例頁面的繪圖。 PagePaintHook 攔截程式是搭配 PageSetupDlg 函式使用的應用程式定義或連結庫定義回呼函式。

LPPAGEPAINTHOOK 類型會定義這個回呼函式的指標。 PagePaintHook 是應用程式定義或連結庫定義函數名稱的佔位元。

語法

LPPAGEPAINTHOOK Lppagepainthook;

UINT_PTR Lppagepainthook(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

參數

unnamedParam1

[頁面設定] 對話框的句柄。

unnamedParam2

正在接收之訊息的標識碼。

unnamedParam3

有關訊息的其他資訊。 確切的意義取決於 unnamedParam2 參數的值。

unnamedParam4

有關訊息的其他資訊。 確切的意義取決於 unnamedParam2 參數的值。

傳回值

如果勾點程式針對繪圖順序的前三個訊息傳回 TRUE ， (WM_PSD_PAGESETUPDLG、 WM_PSD_FULLPAGERECT或 WM_PSD_MINMARGINRECT) ，則對話方塊不會再傳送任何訊息，而且下次系統需要重新繪製範例頁面之前，才會在範例頁面中繪製。 如果這三則訊息的攔截程式傳回 FALSE ，對話框會傳送繪圖序列的其餘訊息。

如果勾點程式針對繪圖順序中剩餘的任何訊息傳回 TRUE ，對話框就不會繪製範例頁面的對應部分。 如果這些訊息的攔截程式傳回 FALSE ，對話框會繪製範例頁面的該部分。

備註

[ 頁面設定 ] 對話框包含範例頁面的影像，其中顯示使用者選取專案如何影響列印輸出的外觀。 影像包含代表選取紙張或信封類型的矩形，以及代表目前邊界的虛線矩形，以及部分 (希臘文文字) 字元，以顯示文字在列印頁面上的外觀。 當您使用 PageSetupDlg 函式建立 頁面設定 對話框時，您可以提供 PagePaintHook 攔截程式來自定義範例頁面的外觀。

若要啟用攔截程式，請使用您傳遞至建立函式的 PAGESETUPDLG 結構。 在 lpfnPagePaintHook 成員中指定攔截程式的指標，並在 Flags 成員中指定PSD_ENABLEPAGEPAINTHOOK旗標。

每當對話框即將繪製範例頁面的內容時，攔截程式就會依列出的順序接收下列訊息。

訊息	意義
WM_PSD_PAGESETUPDLG	對話框即將繪製範例頁面。 攔截程式可以使用此訊息來準備繪製範例頁面的內容。
WM_PSD_FULLPAGERECT	對話框即將繪製範例頁面。 此訊息會指定範例頁面的周框。
WM_PSD_MINMARGINRECT	對話框即將繪製範例頁面。 此訊息會指定邊界矩形。
WM_PSD_MARGINRECT	對話框即將繪製邊界矩形。
WM_PSD_GREEKTEXTRECT	對話框即將在邊界矩形內繪製希臘文文字。
WM_PSD_ENVSTAMPRECT	對話框即將在信封範例頁面的信封戳矩形中繪製。 此郵件只會傳送給信封。
WM_PSD_YAFULLPAGERECT	對話框即將繪製信封範例頁面的傳回位址部分。 此郵件會傳送給信封和其他紙張大小。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	commdlg.h (包含 Windows.h)

另請參閱

通用對話框連結庫

概念

PAGESETUPDLG

PageSetupDlg

參考