SetupHookProc

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

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

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

פרמטרים

hdlg
לטפל לחלון הגדרת הדפסה נפוצות הדו-שיח תיבת אליה יועדה ההודעה.
uiMsg
מזהה ההודעה מתקבלים.
wParam
ציון מידע נוסף אודות ההודעה. משמעותו המדויקת תלויה בערך הפרמטר uiMsg.
lParam
ציון מידע נוסף אודות ההודעה. משמעותו המדויקת תלויה בערך הפרמטר uiMsg.

להחזיר ערכים

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

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

הערות

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

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

הפרוצדורה תיבת הדו-שיח ברירת המחדל מעבד את הודעת 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, PrintDlg, PRINTDLG, PostMessage, WM_INITDIALOG, WM_CTLCOLORDLG

Index