AppendMenu

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

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

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

פרמטרים

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

Index