MENUITEMINFO

המבנה MENUITEMINFO מכיל מידע אודות פריט תפריט.

typedef struct tagMENUITEMINFO {
    UINT cbSize; 
    UINT fMask; 
    UINT fType; 
    UINT fState; 
    UINT wID; 
    HMENU hSubMenu; 
    HBITMAP hbmpChecked; 
    HBITMAP hbmpUnchecked; 
    DWORD dwItemData; 
    LPTSTR dwTypeData; 
    UINT cch; 
} MENUITEMINFO, רחוק * LPMENUITEMINFO 

 

חברים

cbSize

הגודל של מבנה, בבתים.

fMask

חברים כדי לאחזר או בחר. חבר זה יכול להיות אחד או יותר מהערכים האלה:

ערך	משמעות
MIIM_CHECKMARKS	אחזור או מגדיר את החברים hbmpChecked ו- hbmpUnchecked.
MIIM_DATA	אחזור או מגדיר את החבר dwItemData.
MIIM_ID	אחזור או מגדיר את החבר wID.
MIIM_STATE	אחזור או מגדיר את החבר fState.
MIIM_SUBMENU	אחזור או מגדיר את החבר hSubMenu.
MIIM_TYPE	אחזור או מגדיר fType וחברי dwTypeData.

fType

סוג פריט תפריט. חבר זה יכול להיות אחד או יותר מהערכים האלה:

ערך	משמעות
MFT_BITMAP	הצגת פריט התפריט באמצעות מפת סיביות. המילה מסדר נמוך של החבר dwTypeData הוא המזהה הייחודי של מפת סיביות, והמערכת מתעלמת חבר cch.
MFT_MENUBARBREAK	ממקם את פריט התפריט בשורה חדשה (עבור שורת תפריטים) או בעמודה חדשה (עבור התפריט הנפתח, משנה או תפריט קיצור). עבור התפריט הנפתח, משנה או תפריט הקיצור, קו אנכי מפריד את העמודה החדשה הישן.
MFT_MENUBREAK	ממקם את פריט התפריט בשורה חדשה (עבור שורת תפריטים) או בעמודה חדשה (עבור התפריט הנפתח, משנה או תפריט קיצור). עבור התפריט הנפתח, משנה או תפריט הקיצור, העמודות אינם מופרדים על-ידי קו אנכי.
MFT_OWNERDRAW	מקצה אחריות ציור פריט התפריט לחלון הנמצאים בבעלות על התפריט. החלון מקבל הודעה WM_MEASUREITEM לפני הצגת התפריט בפעם הראשונה ולאחר הודעה WM_DRAWITEM בכל פעם, יש לעדכן את המראה של פריט התפריט. אם ערך זה מצוין, חבר dwTypeData מכיל ערך 32 סיביות מוגדר על-ידי יישום.
MFT_RADIOCHECK	הצגת בדקו את פריטי התפריט באמצעות לחצן אפשרויות סמן במקום סימן ביקורת אם החבר hbmpChecked הוא NULL.
MFT_RIGHTJUSTIFY	יישור מימין את פריט התפריט ואת כל הפריטים הבאים. ערך זה הוא חוקי רק אם פריט התפריט בשורת התפריטים.
MFT_RIGHTORDER	Windows 95, Windows NT 5.0 ואילך:ציון תפריטים לדרג מימין לשמאל (ברירת המחדל היא משמאל לימין). משמש לתמיכה בשפות מימין לשמאל, כגון עברית וערבית. `
MFT_SEPARATOR	ציון הפריט בתפריט מפריד. מפריד פריט התפריט מופיע כקו המפריד האופקי. המערכת מתעלמת dwTypeData וחברי cch . ערך זה הוא חוקי רק בתפריט נפתח, המשנה או תפריט קיצור.
MFT_STRING	הצגת פריט התפריט באמצעות מחרוזת טקסט. חבר dwTypeData הוא המצביע אל מחרוזת המסתיימת ב- null, חבר cch הוא האורך של מחרוזת.

לא ניתן לשלב את הערכים MFT_BITMAP, MFT_SEPARATOR ו- MFT_STRING אחד עם השני.

fState

מצב של פריט התפריט. חבר זה יכול להיות אחד או יותר מהערכים האלה:

ערך	משמעות
MFS_CHECKED	בודק את פריט התפריט. לקבלת מידע נוסף אודות פריטי תפריט המסומן, ראה חבר hbmpChecked.
MFS_DEFAULT	ציון פריט התפריט הוא ברירת המחדל. תפריט יכול להכיל אחד בלבד פריט תפריט ברירת המחדל, ואשר מוצג בגופן מודגש.
MFS_DISABLED	מבטל את פריט התפריט כך לא ניתן לבחור, אך לא אפור אותו.
MFS_ENABLED	הופך את פריט התפריט כך שניתן יהיה לבחור. זהו מצב ברירת המחדל.
MFS_GRAYED	מבטל את פריט התפריט, grays אותו, כך לא ניתן לבחור.
MFS_HILITE	מסמן את פריט התפריט.
MFS_UNCHECKED	Unchecks את פריט התפריט. לקבלת מידע נוסף אודות פריטי תפריט לא מסומן, ראה חבר hbmpUnchecked.
MFS_UNHILITE	מסירה את גולת הכותרת של פריט התפריט. זהו מצב ברירת המחדל.

wID

מוגדר על-ידי יישום 16 סיביות ערך אשר מזהה את פריט התפריט.

hSubMenu

לטפל הנפתח או המשנה המשויכות פריט התפריט. אם פריט התפריט הוא לא פריט שפותח תפריט נפתח או תפריט משנה, חבר זה הוא NULL.

hbmpChecked

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

hbmpUnchecked

נקודת אחיזה מפת הסיביות להצגה לצד הפריט, אם הוא לא ייבדק. אם חבר זה הוא NULL, וותר משמש.

dwItemData

ערך המוגדר על-ידי היישום המשויך לפריט התפריט.

dwTypeData

התוכן של פריט התפריט. חבר זה משמש רק אם הדגל MIIM_TYPE מוגדר חבר fMask.

לפני הקריאה GetMenuItemInfo, היישום עליך להגדיר איבר זה כדי להצביע על מאגר שאת אורכו שצוין על-ידי חבר cch. אם פריט התפריט המאוחזרים הוא מסוג MFT_STRING, ולאחר מכן GetMenuItemInfo מעתיק את הטקסט בפריט תפריט למאגר. אם פריט התפריט המאוחזרים של סוג אחר, לאחר מכן GetMenuItemInfo מגדיר את החבר dwTypeData ערך שסוג שצוין על-ידי האיבר fType.

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

cch

אורך הטקסט של פריט תפריט בעת קבלת מידע אודות פריט תפריט מסוג MFT_STRING. חבר זה משמש רק אם הדגל MIIM_TYPE מוגדר חבר fMask הוא אפס אחרת. חבר זה מתעלמת כאשר התוכן של פריט תפריט מוגדר על-ידי קריאה SetMenuItemInfo.

לפני הקריאה GetMenuItemInfo, היישום חייב להגדיר איבר זה כ אורך המאגר הצביע על-ידי חבר dwTypeData . אם פריט התפריט המאוחזרים מסוג MFT_STRING (כפי שמצוין על-ידי האיבר fType ), GetMenuItemInfo מגדיר cch אורך המחרוזת המאוחזרים. אם פריט התפריט המאוחזרים של סוג אחר, GetMenuItemInfo מגדיר את השדה cch אפס.

הערות

המבנה MENUITEMINFO נעשה עם הפונקציות GetMenuItemInfo InsertMenuItem, SetMenuItemInfo.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 4.0 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
Unicode:מוגדר כ- Unicode ומבני ANSI.

ראה גם

מבט כולל תפריטים, תפריט מבנים, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM