CFHookProc

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

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

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

פרמטרים

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

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

להחזיר ערכים

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

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

הערות

בעת שימוש בפונקציה ChooseFont כדי ליצור תיבת הדו-שיח גופן , באפשרותך לספק שגרה הוו CFHookProc כדי לעבד הודעות או הודעות המיועד עבור הפרוצדורה של תיבת הדו-שיח. כדי להפעיל את השגרה הוו, תשתמש במבנה CHOOSEFONT שעברו אל הפונקציה יצירת דו-שיח. ציין את הכתובת של ההליך הוו חבר lpfnHook ולציין את הדגל CF_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:לא נתמך.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:מוגדרת על-ידי המשתמש.

ראה גם

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

Index