ההליך הוו PagePaintHook הוא פונקציית התקשרות חזרה מוגדרת על-ידי יישום או מוגדרת על-ידי הספריה בהם משתמשים עם הפונקציה PageSetupDlg . פונקציה זו מקבלת הודעות המאפשרות לך להתאים אישית את הציור של עמוד דוגמה בתיבת הדו-שיח הגדרת עמוד.
סוג LPPAGEPAINTHOOK מגדיר מצביע לפונקציה זו התקשרות חזרה. PagePaintHook הוא מציין מיקום עבור שם הפונקציה המוגדרת על-ידי יישום או מוגדרת על-ידי הספריה.
(UINT התקשרות חזרה PagePaintHook HWND hdlg, / / לטפל אל חלון תיבת הדו-שיחUINTuiMsg, / / הודעת מזההWPARAMwParam, / / הודעה פרמטרLPARAMlParam / / הודעה פרמטר);
אם ההליך הוו מחזירה TRUE עבור כל אחת מההודעות תחילה רצף הציור (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT או WM_PSD_MINMARGINRECT), בתיבת הדו-שיח שולחת הודעות לא יותר, לא לצייר את עמוד דוגמה עד לפעם הבאה שלמערכת יש צורך לצייר מחדש את עמוד דוגמה. אם ההליך הוו מחזירה FALSE עבור כל שלוש ההודעות, תיבת הדו-שיח שולח את יתר ההודעות ברצף הציור.
אם ההליך הוו מחזירה TRUE עבור כל אחד יתר ההודעות ברצף הציור, תיבת הדו-שיח לא מושך את החלק המתאים של דף הדוגמה. אם ההליך הוו מחזירה FALSE עבור אחת מהודעות אלה, תיבת הדו-שיח מצייר בחלק זה של עמוד דוגמה.
תיבת הדו-שיח הגדרת עמוד כולל תמונה של עמוד דוגמה המציגה כיצד הבחירות של המשתמש משפיעים על המראה של הפלט המודפס. התמונה מורכבת מלבן שמייצג את הנייר או המעטפה סוג שנבחר, עם מלבן מנוקד המייצג את השוליים הנוכחיים, חלקי (טקסט ביוונית) תווים כדי להציג את מראה הטקסט על הדף המודפס. בעת שימוש בפונקציה PageSetupDlg כדי ליצור תיבת הדו-שיח הגדרת עמוד , באפשרותך לספק שגרה הוו PagePaintHook כדי להתאים אישית את המראה של עמוד דוגמה.
כדי להפעיל את השגרה הוו, תשתמש במבנה PAGESETUPDLG שעברו אל הפונקציה יצירת דו-שיח. ציין את המצביע אל השגרה הוו חבר lpfnPagePaintHook וציין את הדגל PSD_ENABLEPAGEPAINTHOOK חבר דגלים.
כאשר תיבת הדו-שיח עומד לצייר את התוכן של דף הדוגמה, ההליך הוו מקבל את ההודעות הבאות בסדר בו הם מפורטים:
| הודעה | משמעות |
| WM_PSD_PAGESETUPDLG | תיבת הדו-שיח עומד לצייר את עמוד דוגמה. ההליך hook להשתמש הודעה זו כדי להכין לצייר את התוכן של עמוד דוגמה. |
| WM_PSD_FULLPAGERECT | תיבת הדו-שיח עומד לצייר את עמוד דוגמה. הודעה זו מציינת את המלבן התוחם של עמוד דוגמה. |
| WM_PSD_MINMARGINRECT | תיבת הדו-שיח עומד לצייר את עמוד דוגמה. הודעה זו מציינת את המלבן שוליים. |
| WM_PSD_MARGINRECT | תיבת הדו-שיח עומד לצייר את המלבן שוליים. |
| WM_PSD_GREEKTEXTRECT | תיבת הדו-שיח עומד לצייר את הטקסט היווני בתוך המלבן שוליים. |
| WM_PSD_ENVSTAMPRECT | תיבת הדו-שיח עומד לצייר את המלבן מעטפה-חותמת של דף הדוגמה מעטפה. הודעה זו תישלח עבור מעטפות בלבד. |
| WM_PSD_YAFULLPAGERECT | תיבת הדו-שיח עומד לצייר את החלק בכתובת השולח של דף הדוגמה מעטפה. הודעה זו תישלח עבור מעטפות אחרות גדלי נייר. |
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:מוגדרת על-ידי המשתמש.
סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות של תיבת הדו-שיח, PageSetupDlg, PAGESETUPDLG