הפונקציה AppendMenu מוסיפה פריט חדש בסוף שורת התפריטים שצוינה, ובתפריט שייפתח, משנה או בתפריט הקיצור. באפשרותך להשתמש בפונקציה זו כדי לציין את התוכן, את המראה ואופן הפעולה של פריט התפריט.
הפונקציה AppendMenu הוחלף על-ידי הפונקציה InsertMenuItem . באפשרותך עדיין להשתמש AppendMenu, עם זאת, אם אינך צריך כל התכונות המורחבות של InsertMenuItem.
(BOOL AppendMenu HMENU hMenu, / / לטפל לתפריט שינויUINTuFlags, / / מסמן בדגל של פריט בתפריטUINTuIDNewItem, / / מזהה פריט תפריט או נקודת האחיזה כדי נפתחת או תפריט משנהLPCTSTRlpNewItem / / פריט תפריט תוכן);
ערך | תיאור |
---|---|
MF_BITMAP | מכיל נקודת אחיזה מפת סיביות. |
MF_OWNERDRAW | מכיל ערך של 32 סיביות שסופק על-ידי היישום שבאמצעותו ניתן יהיה לשמור על נתונים נוספים הקשורים פריט התפריט. הערך הוא חבר נתוני פריט הצביע על-ידי הפרמטר lparam של WM_MEASURE המבנה או WM_DRAWITEM ההודעה נשלחת כאשר התפריט נוצר או מעודכן המראה שלו. |
MF_STRING | מכיל מצביע מחרוזת המסתיימת ב- null. |
אם הפונקציה מצליחה, הערך המוחזר אינו אפס.
אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
היישום חייב לבצע קריאה לפונקציה DrawMenuBar בכל פעם תפריט משתנה, התפריט נמצא בחלון המוצג.
כדי לקבל האצה לעבוד עם מפת סיביות או פריטי תפריט שצוירו על-ידי הבעלים, הבעלים של התפריט עליך לעבד את ההודעה WM_MENUCHAR. לקבלת מידע נוסף, ראה את ההודעה WM_MENUCHAR ותפריטים Owner-Drawn.
הדגלים הבאים ניתן להגדיר את הפרמטר uFlags:
ערך | תיאור |
---|---|
MF_BITMAP | משתמש מפת סיביות כמו פריט התפריט. הפרמטר lpNewItem מכיל את נקודת האחיזה מפת הסיביות. |
MF_CHECKED | מציב סימן ביקורת לצד פריט תפריט. אם היישום מספק מפות סיביות של סימן הביקורת (ראה SetMenuItemBitmaps, זו מציגה דגל מפת סיביות סימן ביקורת לצד פריט תפריט. |
MF_DISABLED | מבטל את פריט התפריט כך לא ניתן לבחור, אך הדגל אפור זה לא. |
MF_ENABLED | הופך את פריט התפריט כך הוא יכול להיבחר ומשחזר אותה החל למצבו אפורה. |
MF_GRAYED | מבטל את פריט התפריט, grays אותו ולכן לא ניתן לבחור. |
MF_MENUBARBREAK | פונקציות זהה MF_MENUBREAK דגל עבור שורת תפריטים. עבור התפריט הנפתח, משנה או תפריט הקיצור, העמודה החדשה המופרד העמודה ישן על-ידי קו אנכי. |
MF_MENUBREAK | ממקם את הפריט בשורה חדשה (עבור שורת תפריטים) או בעמודה חדשה (עבור התפריט הנפתח, משנה או תפריט קיצור) ללא הפרדת עמודות. |
MF_OWNERDRAW | ציון הפריט הוא פריט שצוירו על-ידי הבעלים. לפני הצגת התפריט בפעם הראשונה, החלון שבו מחזיקה את התפריט מקבל הודעה WM_MEASUREITEM כדי לאחזר את הרוחב ואת הגובה של פריט התפריט. WM_DRAWITEM מכן נשלחת הודעת ההליך חלון של חלון הבעלים בכל פעם, יש לעדכן את המראה של פריט התפריט. |
MF_POPUP | ציון הפריט בתפריט נפתח תפריט נפתחת או תפריט. הפרמטר uIDNewItem מציין את נקודת האחיזה כדי או נפתחת בתפריט המשנה. דגל זה נמצא בשימוש כדי להוסיף שם תפריט בשורת תפריטים או פריט בתפריט נפתח תפריט משנה בתפריט הנפתח, המשנה, או תפריט קיצור. |
MF_SEPARATOR | ציור קו המפריד האופקי. דגל זה נמצא בשימוש רק התפריט הנפתח, משנה או בתפריט הקיצור. הקו ניתן אפורה, ללא זמין, או מודגש. המערכת מתעלמת מן הפרמטרים lpNewItem ו- uIDNewItem. |
MF_STRING | ציון פריט התפריט הוא מחרוזת טקסט; הפרמטר lpNewItem מצביע המחרוזת. |
MF_UNCHECKED | תציב סימן ביקורת לצד הפריט (ברירת המחדל). אם היישום מספקת מפות סיביות של סימן הביקורת (ראה SetMenuItemBitmaps), דגל זה מציג את מפת הסיביות לא מסומן לצד פריט התפריט. |
אין אפשרות להשתמש יחד הקבוצות הבאות של דגלים:
חלונות CE: הדגלים הבאים אינם נתמכים עבור הפרמטר fuFlags
MF_BITMAP
MF_DISABLED
MFS_GRAYED
ניתן להשתמש MF_GRAYED במקום MF_DISABLED MFS_GRAYED.
Windows CE 1.0 אינו תומך בתפריטים מדורגים. אם אתה משתמש ב- Windows CE 1.0, אין אפשרות להוסיף גם תפריט MF_POPUP לתוך אחר תפריט מוקפץ.
ב- Windows CE 1.0, הדגלים הבאים אינם נתמכים:
MF_POPUP
MF_MENUBREAK
MF_MENUBARBREAK
ב- Windows CE בגירסה 2.0 ואילך, דגלים אלה נתמכים. תפריטים מדורגים נתמכים גם.
מבט כולל תפריטים, תפריט פונקציות, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps