המבנה 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
ערך | משמעות |
---|---|
MIIM_CHECKMARKS | אחזור או מגדיר את החברים hbmpChecked ו- hbmpUnchecked. |
MIIM_DATA | אחזור או מגדיר את החבר dwItemData. |
MIIM_ID | אחזור או מגדיר את החבר wID. |
MIIM_STATE | אחזור או מגדיר את החבר fState. |
MIIM_SUBMENU | אחזור או מגדיר את החבר hSubMenu. |
MIIM_TYPE | אחזור או מגדיר fType וחברי dwTypeData. |
ערך | משמעות |
---|---|
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 אחד עם השני.
ערך | משמעות |
---|---|
MFS_CHECKED | בודק את פריט התפריט. לקבלת מידע נוסף אודות פריטי תפריט המסומן, ראה חבר hbmpChecked. |
MFS_DEFAULT | ציון פריט התפריט הוא ברירת המחדל. תפריט יכול להכיל אחד בלבד פריט תפריט ברירת המחדל, ואשר מוצג בגופן מודגש. |
MFS_DISABLED | מבטל את פריט התפריט כך לא ניתן לבחור, אך לא אפור אותו. |
MFS_ENABLED | הופך את פריט התפריט כך שניתן יהיה לבחור. זהו מצב ברירת המחדל. |
MFS_GRAYED | מבטל את פריט התפריט, grays אותו, כך לא ניתן לבחור. |
MFS_HILITE | מסמן את פריט התפריט. |
MFS_UNCHECKED | Unchecks את פריט התפריט. לקבלת מידע נוסף אודות פריטי תפריט לא מסומן, ראה חבר hbmpUnchecked. |
MFS_UNHILITE | מסירה את גולת הכותרת של פריט התפריט. זהו מצב ברירת המחדל. |
לפני הקריאה GetMenuItemInfo, היישום עליך להגדיר איבר זה כדי להצביע על מאגר שאת אורכו שצוין על-ידי חבר cch. אם פריט התפריט המאוחזרים הוא מסוג MFT_STRING, ולאחר מכן GetMenuItemInfo מעתיק את הטקסט בפריט תפריט למאגר. אם פריט התפריט המאוחזרים של סוג אחר, לאחר מכן GetMenuItemInfo מגדיר את החבר dwTypeData ערך שסוג שצוין על-ידי האיבר fType.
בעת שימוש עם הפונקציה SetMenuItemInfo , חבר זה אמור מכיל ערך שסוג שצוין על-ידי האיבר fType.
לפני הקריאה GetMenuItemInfo, היישום חייב להגדיר איבר זה כ אורך המאגר הצביע על-ידי חבר dwTypeData . אם פריט התפריט המאוחזרים מסוג MFT_STRING (כפי שמצוין על-ידי האיבר fType ), GetMenuItemInfo מגדיר cch אורך המחרוזת המאוחזרים. אם פריט התפריט המאוחזרים של סוג אחר, GetMenuItemInfo מגדיר את השדה cch אפס.
המבנה MENUITEMINFO נעשה עם הפונקציות GetMenuItemInfo InsertMenuItem, SetMenuItemInfo.
nbsp; Windows &NT: מחייב גירסה 4.0 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
Unicode:מוגדר כ- Unicode ומבני ANSI.
מבט כולל תפריטים, תפריט מבנים, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM