הפונקציה InsertMenu מוסיף פריט תפריט חדש לתוך תפריט, העברת פריטים אחרים למטה בתפריט.
הפונקציה InsertMenu הוחלף על-ידי הפונקציה InsertMenuItem . באפשרותך עדיין להשתמש InsertMenu, עם זאת, אם אינך צריך כל התכונות המורחבות של InsertMenuItem.
(BOOL InsertMenu HMENU hMenu, / / לטפל לתפריטUINTuPosition, / / תפריט פריט תפריט חדש זה הפריט הקודםUINTuFlags, / / מסמן בדגל של פריט בתפריטUINTuIDNewItem, / / תפריט מזהה פריט או לטפל הנפתחת / / תפריט או תפריט משנהLPCTSTRlpNewItem / / פריט תפריט תוכן);
ערך | תיאור |
---|---|
MF_BYCOMMAND | מציין הפרמטר uPosition נותן את המזהה של פריט התפריט. דגל MF_BYCOMMAND הוא ברירת המחדל אם צוין דגל לא MF_BYCOMMAND ולא MF_BYPOSITION. |
MF_BYPOSITION | מציין הפרמטר uPosition נותן מבוסס אפס המיקום היחסי של פריט תפריט חדש. אם uPosition הוא 0xFFFFFFFF, פריט תפריט חדש מוצמד לסופו של תפריט. |
ערך | תיאור |
---|---|
MF_BITMAP | מכיל נקודת אחיזה מפת סיביות. |
MF_OWNERDRAW | מכיל ערך של 32 סיביות שסופק על-ידי היישום שבאמצעותו ניתן יהיה לשמור על נתונים נוספים הקשורים פריט התפריט. הערך הוא חבר נתוני פריט מבנה הצביע על-ידי הפרמטר lparam של WM_MEASUREITEM או WM_DRAWITEM ההודעה נשלחת כאשר פריט התפריט נוצר או מעודכן המראה שלה. |
MF_STRING | מכיל מצביע מחרוזת המסתיימת ב- null (ברירת מחדל). |
אם הפונקציה מצליחה, הערך המוחזר אינו אפס.
אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
היישום חייב לבצע קריאה לפונקציה DrawMenuBar בכל פעם תפריט משתנה, התפריט נמצא בחלון המוצג.
הרשימה הבאה מתארת את הדגלים שניתן להגדיר בפרמטר 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: Windows CE אינו תומך לדגל MF_BITMAP או את הדגל MF_DISABLED בפרמטר uFlags . אין אפשרות לבטל את פריטי התפריט מבלי להיות אפור. כדי להפוך פריט תפריט השתמש בדגל MF_GRAYED.
Windows CE גירסה 1.0 אינו תומך בתפריטים מדורגים. אם אתה משתמש ב- Windows CE 1.0, אין אפשרות להכניס גם תפריט MF_POPUP אחר בתפריט הנפתח. אם השימוש ב- Windows CE 2.0 או גירסה מתקדמת יותר, באפשרותך.
מבט כולל תפריטים, תפריט פונקציות, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM