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