PageSetupHook

ההליך הוו PageSetupHook הוא פונקציית התקשרות חזרה מוגדרת על-ידי יישום או מוגדרת על-ידי הספריה בהם משתמשים עם הפונקציה PageSetupDlg . הפונקציה מקבלת דיווחים המיועד עבור הפרוצדורה תיבת הדו-שיח ברירת המחדל של תיבת הדו-שיח הגדרת עמוד נפוצות או הודעות.

סוג LPPAGESETUPHOOK מגדיר מצביע לפונקציה זו התקשרות חזרה. PageSetupHook הוא מציין מיקום עבור שם הפונקציה המוגדרת על-ידי יישום או מוגדרת על-ידי הספריה.

(UINT התקשרות חזרה PageSetupHook HWND  hdlg, / / לטפל אל חלון תיבת הדו-שיחUINTuiMsg, / / הודעת מזההWPARAMwParam, / / הודעה פרמטרLPARAMlParam / / הודעה פרמטר);
 

פרמטרים

hdlg

לטפל אל חלון תיבת הדו-שיח הגדרת עמוד אשר יועדה ההודעה.

uiMsg

מזהה ההודעה מתקבלים.

wParam

ציון מידע נוסף אודות ההודעה. משמעותו המדויקת תלויה בערך הפרמטר uiMsg.

lParam

ציון מידע נוסף אודות ההודעה. משמעותו המדויקת תלויה בערך הפרמטר uiMsg.

אם הפרמטר uiMsg מציין את ההודעה WM_INITDIALOG , lParam הוא מצביע מבנה PAGESETUPDLG המכיל שהערכים שצוין בעת יצירת תיבת הדו-שיח נפוצות.

להחזיר ערכים

אם ההליך הוו מחזירה אפס, ההליך תיבת הדו-שיח ברירת המחדל מעבד את הודעת.

אם ההליך הוו מחזירה ערך שאינו אפס, ההליך תיבת הדו-שיח ברירת המחדל מתעלם ההודעה.

הערות

בעת שימוש בפונקציה PageSetupDlg כדי ליצור תיבת דו-שיח נפוצות הגדרת עמוד , באפשרותך לספק שגרה הוו PageSetupHook כדי לעבד הודעות או הודעות המיועד עבור הפרוצדורה של תיבת הדו-שיח. כדי להפעיל את השגרה הוו, תשתמש במבנה PAGESETUPDLG שעברו אל הפונקציה יצירת דו-שיח. ציין את המצביע אל השגרה הוו חבר lpfnPageSetupHook וציין את הדגל PSD_ENABLEPAGESETUPHOOK חבר דגלים.

הפרוצדורה תיבת הדו-שיח ברירת המחדל מעבד את הודעת WM_INITDIALOG לפני העברתן ההליך הוו. עבור כל ההודעות האחרות, ההליך הוו מקבל את ההודעה הראשונה. לאחר מכן, הערך המוחזר של ההליך הוו קובע אם הפרוצדורה תיבת דו-שיח ברירת המחדל מעבד את הודעת או יתעלם ממנה.

אם ההליך הוו מעבד את הודעת WM_CTLCOLORDLG , עליה להחזיר נקודת אחיזה מברשת חוקי עבור ציור הרקע של תיבת הדו-שיח. באופן כללי, אם ההליך הוו מעבד כל הודעה WM_CTLCOLOR *, עליה להחזיר נקודת אחיזה מברשת חוקי עבור ציור הרקע של הפקד שצוין.

לא לפונקציה EndDialog מהסדר של ההליך הוו. במקום זאת, ההליך הוו ניתן לבצע קריאה לפונקציה PostMessage כדי להציב הודעה WM_COMMAND עם הערך IDABORT להליך בתיבת הדו-שיח. הצבת IDABORT סוגר את תיבת הדו-שיח וגורמת את הפונקציה בתיבת הדו-שיח לחזור FALSE. אם עליך לדעת מדוע ההליך וו סגור את תיבת הדו-שיח, עליך לספק משלך מנגנון תקשורת בין ההליך הוו היישום שלך.

באפשרותך לתתי פקדים רגילים של תיבת הדו-שיח נפוצות. עם זאת, ההליך נפוצות של תיבת הדו-שיח עשויה גם לתתי הפקדים. עקב כך, עליך פקדים לתתי כאשר הליך הוו שלך מעבד את ההודעה WM_INITDIALOG. דבר זה מבטיח את הליך לתתי מקבל הודעות בקרה ספציפית לפני ההליך לתתי שקבע את הפרוצדורה תיבת הדו-שיח.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:מוגדרת על-ידי המשתמש.

ראה גם

סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות של תיבת הדו-שיח, EndDialog, PageSetupDlg, PAGESETUPDLG, PostMessage, WM_INITDIALOG, WM_CTLCOLORDLG

Index