基本介紹
- 外文名：PagePaintHook
- 類別：計算機函式
- 原型：UINT CALLBACK PagePaintHook
- 功能：接收製作對話框中樣本頁繪圖訊息
函式原型,參數,
函式原型
UINT CALLBACK PagePaintHook（HWND hdlg，UINT uiMsg，WPARAM wParam，LPARAM IParam）；
參數
hdlg：指向pagesetup對話樞視窗的句柄。
uiMsg：標識接收的訊息。
wparam：指定有關訊息的其他信息。精確的意義要根據uiMsg參數的值來決定。
IParam：指定有關訊息的其他信息。精確的意義要根據uiMsg參數的值來決定。
返回值：如果掛鈎函式對前三個繪圖順序訊息中的任何一個返回值為TRUE。且前三個訊息為WM_PSD_PAGESETUPDLG，WM_PSD_FULLPAGERECT或WM_PSD_MINMARGINRECT），對話框不再傳送訊息。且直到下一次系統需要重畫樣本頁時才繪出樣本頁。如果對所有的三個訊息。掛鈎函式返回FALSE，對話框傳送給圖順序的保留的訊息。
如果掛鈎函式對繪圖順序中保留訊息的任何一個，返回值為TRUE，那么對話框不繪樣本頁對應的部分，如果掛鈎函式對這些信息中的任何一個返回值為FALSE，對話框繪樣本頁部分。
備註PageSetup對話框含有一個樣本頁的構想。此構想展示了用戶選擇如何影響列印輸出的外觀。構想由代表選擇頁或信封類型的長方形組成，點線長方形代表當前頁邊。部分字母展示了文本在列印出的頁中的狀況。當用PageSetupDlg函式創建Page Setup Dialog對話框時，可提供一個PagePaintHook掛鈎函式來製作樣本頁的表觀。
為使掛鈎函式生效，須用傳遞到創建對話函式的PAGESETUPDLG結構，且指定一個指向
IpfnPagePrintHook成員中掛鈎函式的指針和指定Flags成員中PSD_ENABLEPAGEPAINTHOOK標誌。
無論何時，只要對話框將要繪樣本頁的內容，那么掛鈎函式就接受以下列順序列表的訊息：WM_PSD_PAGESETUPDLG：對話框將要繪樣本頁，掛鈎函式利用此訊息準備給樣本頁里的內容。
WM_PSD_FULLPAGERECT：對話框要繪樣本頁，此信息指定樣本頁的長方形邊。
WM_PSD_MINMARGINRECT：對話框將要繪樣本頁，此信息指定空白長方形。
WM_PSD_MARGINRECT：對話框將要繪空白長方形。
WM_PSD_REEKTEXTRECT：對話框將要在空白長方形內繪Greek文本。
WM_PSD_ENVSTAMPRECT：對話框將要在信封樣本頁上繪郵票長方形。此訊息僅發向信封。
WM_PSD_YAFULLPAGERECT：對話框將要繪信封樣本頁的返回地址部分。此訊息僅發向信封和其他紙張大小。
速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持：頭檔案：commdlg.h；庫檔案：用戶自定義。
