CCHookProc

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

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

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

פרמטרים

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

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

להחזיר ערכים

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

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

הערות

בעת שימוש בפונקציה ChooseColor כדי ליצור תיבת הדו-שיח צבע , באפשרותך לספק שגרה הוו CCHookProc כדי לעבד הודעות או הודעות המיועד עבור הפרוצדורה של תיבת הדו-שיח. כדי להפעיל את השגרה הוו, תשתמש במבנה CHOOSECOLOR שעברו אל הפונקציה יצירת דו-שיח. ציין את הכתובת של ההליך הוו חבר lpfnHook ולציין את הדגל CC_ENABLEHOOK חבר דגלים.

הפרוצדורה תיבת הדו-שיח ברירת המחדל מעבד את הודעת 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:מחייב גירסה 2.0 או גירסה מתקדמת יותר.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:מוגדרת על-ידי המשתמש.

ראה גם

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

Index