FRHookProc

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

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

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

פרמטרים

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

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

להחזיר ערכים

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

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

הערות

בעת השימוש בפונקציות FindText או החלפת טקסט תחת כדי ליצור חיפוש או החלפה משותפים תיבת דו-שיח, באפשרותך לספק פרוצדורת hook FRHookProc כדי לעבד הודעות או הודעות המיועד עבור הפרוצדורה של תיבת הדו-שיח. כדי להפעיל את השגרה הוו, תשתמש במבנה FINDREPLACE שעברו אל הפונקציה יצירת דו-שיח. ציין את הכתובת של ההליך הוו חבר lpfnHook ולציין את הדגל FR_ENABLEHOOK חבר דגלים.

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

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

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

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

FRHookProc הוא מציין מיקום עבור שם הפונקציה המוגדרת על-ידי יישום או מוגדרת על-ידי הספריה. סוג LPFRHOOKPROC הוא מצביע פרוצדורת hook FRHookProc.

QuickInfo

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

ראה גם

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

Index