תיבות הדו-שיח המשותפות לספק עזרה תלויית הקשר עבור פקדים רגילים של תיבת הדו-שיח. כדי לספק עזרה נוספת עבור תיבת דו-שיח נפוצות, ניתן להציג את לחצן עזרה , לעבד הודעות שנוצרו כאשר המשתמש לוחץ על הלחצן. לחצן עזרה הוא תוספת להצהרת ברירת המחדל עזרה תלויית הקשר. לחצן עזרה שימושי המתארת את מטרת תיבת הדו-שיח כללי כפי שהוא חל על היישום שלך.
בכל תיבות הדו-שיח המשותפות לספק עזרה תלויית הקשר עבור פקדים רגילים של תיבת הדו-שיח. המשתמש יוכל להציג עזרה עבור פקדים בודדים על-ידי אחת מהשיטות הבאות:
אם תיבת הדו-שיח התאמה אישית על-ידי הוספת פקדים חדשים, גם עליך להרחיב את עזרה ותמיכה עבור פקדים אלה על-ידי עיבוד בקשות לעזרה בהליך הוו. ההליך הוו מקבל את ההודעות הבאות כאשר המשתמש מבקש עזרה.
| פעולת משתמש | הודעה |
|---|---|
| המשתמש לוחץ על לחצן העכבר הימני על פקד. | WM_CONTEXTMENU |
| המשתמש נלחץ על מקש f1. | WM_HELP |
| לחיצה על לחצן ? בפס הכותרת של המשתמש ולאחר מכן לחץ על פקד. | WM_HELP |
צריך לעבד הודעות אלה עבור הפקדים יש נוספת, אך לאפשר את ההליך בתיבת הדו-שיח של ברירת המחדל לעבד ההודעות עבור פקדים רגילים. לקבלת מידע נוסף אודות כיצד לעבד הודעות אלה, ראה לסייע מבט כולל על.
באפשרותך להציג לחצן עזרה בכל תיבות הדו-שיח המשותפות על-ידי הגדרת ערך SHOWHELP החבר בדגלים של מבנה אתחול עבור תיבת הדו-שיח. אם בחרת להציג לחצן עזרה , עליך לעבד בקשת המשתמש לקבלת עזרה. העיבוד יכולה להיעשות באחת מהפרוצדורות חלון היישום שלך או בשגרת הוו עבור תיבת הדו-שיח. בדרך כלל, לעבד את הבקשה לקבלת עזרה על-ידי קריאה WinHelp פונקציה.
כדי לעבד הודעות עזרה באחד מההליכים החלון שלך, עליך לקבל מזהה הודעה עבור מחרוזת המוגדרת על-ידי הערך HELPMSGSTRING ולזהות את החלון כדי לקבל הודעות. כדי לקבל את מזהה ההודעה, ציין HELPMSGSTRING כפרמטר בקריאה לפונקציה RegisterWindowMessage . בעת יצירת תיבת הדו-שיח נפוצות, השתמש חבר hwndOwner של מבנה אתחול תיבת הדו-שיח כדי לזהות את החלון כדי לקבל את ההודעות. הפרוצדורה תיבת הדו-שיח שליחת ההודעה ההליך חלון כאשר המשתמש לוחץ על לחצן עזרה.
כדי לעבד הודעות עזרה בשגרת הוו, צריך לעבד את ההודעה WM_COMMAND . ההליך הוו מספק עזרה אם הפרמטר wParam של הודעה זו מציינת כי המשתמש לוחץ על לחצן עזרה . המזהה של לחצן עזרה הוא קבוע pshHelp שהוגדרו על DLGS.קובץ h.
הקרס נהלי בסגנון Explorer פתיחה , שמירה בשם בתיבות דו-שיח כלליות אינם מקבלים הודעות WM_COMMAND עבור לחצן עזרה . במקום זאת, תיבת הדו-שיח שולח הודעת דיווח CDN_HELP להליך הוו בעת לחיצה על לחצן עזרה.