InsertMenu

הפונקציה InsertMenu מוסיף פריט תפריט חדש לתוך תפריט, העברת פריטים אחרים למטה בתפריט.

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

(BOOL InsertMenu HMENU  hMenu, / / לטפל לתפריטUINTuPosition, / / תפריט פריט תפריט חדש זה הפריט הקודםUINTuFlags, / / מסמן בדגל של פריט בתפריטUINTuIDNewItem, / / תפריט מזהה פריט או לטפל הנפתחת / / תפריט או תפריט משנהLPCTSTRlpNewItem / / פריט תפריט תוכן);
 

פרמטרים

hMenu
לטפל לתפריט שינוי.
uPosition
מציין את פריט התפריט שלפניה פריט תפריט חדש הוא להוסיף, כפי שנקבע על-ידי הפרמטר uFlags.
uFlags
מציין דגלים הקובעות את הפרשנות של הפרמטר uPosition ואת התוכן, המראה ואופן הפעולה של פריט תפריט חדש. פרמטר זה חייב להיות שילוב של אחד הערכים הנדרשים הבאים לפחות באחד הערכים המפורטים בסעיף הערות הבא.
ערך תיאור
MF_BYCOMMAND מציין הפרמטר uPosition נותן את המזהה של פריט התפריט. דגל MF_BYCOMMAND הוא ברירת המחדל אם צוין דגל לא MF_BYCOMMAND ולא MF_BYPOSITION.
MF_BYPOSITION מציין הפרמטר uPosition נותן מבוסס אפס המיקום היחסי של פריט תפריט חדש. אם uPosition הוא 0xFFFFFFFF, פריט תפריט חדש מוצמד לסופו של תפריט.

uIDNewItem
מציין את המזהה של פריט תפריט חדש או, אם הפרמטר uFlags הדגל MF_POPUP בחר, את נקודת האחיזה כדי או בתפריט הנפתח המשנה.
lpNewItem
מציין את התוכן של פריט תפריט חדש. הפירוש של lpNewItem תלוי אם הפרמטר uFlags כולל את דגל MF_BITMAP, MF_OWNERDRAW או MF_STRING, כדלקמן:
ערך תיאור
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

Index