ModifyMenu

הפונקציה ModifyMenu משתנה פריט תפריט קיים. פונקציה זו משמשת כדי לציין את התוכן, את המראה ואופן הפעולה של פריט התפריט.

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

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

פרמטרים

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

uIDNewItem
מציין את המזהה של פריט התפריט ששונה או, אם הפרמטר uFlags הדגל MF_POPUP בחר, את נקודת האחיזה כדי או בתפריט הנפתח המשנה.
lpNewItem
מצביע על התוכן של פריט התפריט שהשתנו. הפירוש של פרמטר זה תלוי אם הפרמטר uFlags כוללת את הדגל MF_BITMAP, MF_OWNERDRAW או MF_STRING.
ערך משמעות
MF_BITMAP מכיל נקודת אחיזה מפת סיביות.
MF_OWNERDRAW מכיל ערך של 32 סיביות שסופק על-ידי יישום המשמש כדי לשמור על נתונים נוספים הקשורים פריט התפריט. הערך הוא חבר נתוני פריט של המבנה הצביע על-ידי הפרמטר lparam של WM_MEASUREITEM או WM_DRAWITEM של הודעות שנשלחו כאשר פריט התפריט נוצר או מעודכן המראה שלה.
MF_STRING מכיל מצביע מחרוזת המסתיימת ב- null (ברירת מחדל).

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

אם ModifyMenu מחליף פריט בתפריט נפתח תפריט נפתחת או תפריט, הפונקציה הורסת את הישן נפתחת או תפריט משנה ומשחרר זיכרון המשמש אותו.

מנת האצה לעבוד עם מפת סיביות או פריטי תפריט שצוירו על-ידי הבעלים, הבעלים של התפריט עליך לעבד את ההודעה WM_MENUCHAR. ראה תפריטים Owner-Drawn ואת ההודעה WM_MENUCHAR לקבלת מידע נוסף.

היישום חייב לפונקציה DrawMenuBar בכל פעם תפריט משתנה, התפריט נמצא בחלון המוצג. כדי לשנות את התכונות של פריטי התפריט הקיים, היא מהירה בהרבה כדי להשתמש בפונקציות CheckMenuItem ו- EnableMenuItem.

הרשימה הבאה מתארת את הדגלים אשר ניתן להגדיר בפרמטר uFlags:

ערך משמעות
MF_BITMAP משתמש מפת סיביות כמו פריט התפריט. הפרמטר lpNewItem מכיל את נקודת האחיזה מפת הסיביות.
MF_BYCOMMAND מציין את הפרמטר uPosition מציין את המזהה של פריט התפריט (ברירת מחדל).
MF_BYPOSITION מציין את הפרמטר uPosition מציין המיקום היחסי מבוסס אפס של פריט תפריט חדש.
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 ), דגל זה מציג bitmap לא מסומן לצד פריט התפריט.

אין אפשרות להשתמש יחד הקבוצות הבאות של דגלים:

ראה גם

מבט כולל תפריטים, תפריט פונקציות, AppendMenu, CheckMenuItem, DrawMenuBar, EnableMenuItem, SetMenuItemBitmaps, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM

Index