MENUITEMINFO
The MENUITEMINFO
structure contains information about a menu item.
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, FAR *LPMENUITEMINFO;
Members
cbsize
Size of
structure, in bytes.
fMask
Members to
retrieve or set. This member can be one or more of these values:
|
Value |
Meaning |
|
MIIM_CHECKMARKS |
Retrieves
or sets the hbmpChecked and hbmpUnchecked members. |
|
MIIM_DATA |
Retrieves
or sets the dwItemData member. |
|
MIIM_ID |
Retrieves
or sets the wID member. |
|
MIIM_STATE |
Retrieves
or sets the fState member. |
|
MIIM_SUBMENU |
Retrieves
or sets the hSubMenu member. |
|
MIIM_TYPE |
Retrieves
or sets the fType and dwTypeData members. |
fType
Menu item
type. This member can be one or more of these values:
|
Value |
Meaning |
|
MFT_BITMAP |
Displays
the menu item using a bitmap. The low-order word of the dwTypeData
member is the bitmap handle, and the cch member is ignored. |
|
MFT_MENUBARBREAK |
Places the
menu item on a new line (for a menu bar) or in a new column (for a drop-down
menu, submenu, or shortcut menu). For a drop-down menu, submenu, or shortcut
menu, a vertical line separates the new column from the old. |
|
MFT_MENUBREAK |
Places the
menu item on a new line (for a menu bar) or in a new column (for a drop-down
menu, submenu, or shortcut menu). For a drop-down menu, submenu, or shortcut
menu, the columns are not separated by a vertical line. |
|
MFT_OWNERDRAW |
Assigns
responsibility for drawing the menu item to the window that owns the menu.
The window receives a WM_MEASUREITEM message before the menu is displayed for the
first time, and a WM_DRAWITEM
message whenever the appearance of the menu item must be updated. If this
value is specified, the dwTypeData member contains an
application-defined 32-bit value. |
|
MFT_RADIOCHECK |
Displays
checked menu items using a radio-button mark instead of a check mark if the hbmpChecked
member is NULL. |
|
MFT_RIGHTJUSTIFY |
Right-justifies
the menu item and any subsequent items. This value is valid only if the menu
item is in a menu bar. |
|
MFT_SEPARATOR |
Specifies
that the menu item is a separator. A menu item separator appears as a
horizontal dividing line. The dwTypeData and cch members are
ignored. This value is valid only in a drop-down menu, submenu, or shortcut
menu. |
|
MFT_STRING |
Displays
the menu item using a text string. The dwTypeData member is the
pointer to a null-terminated string, and the cch member is the length
of the string. |
The
MFT_BITMAP, MFT_SEPARATOR, and MFT_STRING values cannot be combined with one
another.
fState
Menu item
state. This member can be one or more of these values:
|
Value |
Meaning |
|
MFS_CHECKED |
Checks the
menu item. For more information about checked menu items, see the hbmpChecked
member. |
|
MFS_DEFAULT |
Specifies
that the menu item is the default. A menu can contain only one default menu
item, which is displayed in bold. |
|
MFS_DISABLED |
Disables
the menu item so that it cannot be selected, but does not gray it. |
|
MFS_ENABLED |
Enables the
menu item so that it can be selected. This is the default state. |
|
MFS_GRAYED |
Disables
the menu item and grays it so that it cannot be selected. |
|
MFS_HILITE |
Highlights
the menu item. |
|
MFS_UNCHECKED |
Unchecks
the menu item. For more information about unchecked menu items, see the hbmpUnchecked
member. |
|
MFS_UNHILITE |
Removes the
highlight from the menu item. This is the default state. |
wID
Application-defined
16-bit value that identifies the menu item.
hSubMenu
Handle to the
drop-down menu or submenu associated with the menu item. If the menu item is
not an item that opens a drop-down menu or submenu, this member is NULL.
hbmpChecked
Handle to the
bitmap to display next to the item if it is checked. If this member is NULL, a
default bitmap is used. If the MFT_RADIOCHECK type value is specified, the
default bitmap is a bullet. Otherwise, it is a check mark.
hbmpUnchecked
Handle to the
bitmap to display next to the item if it is not checked. If this member is
NULL, no bitmap is used.
dwItemData
Application-defined
value associated with the menu item.
dwTypeData
Content of
the menu item. The meaning of this member depends on the menu item type: the
MFT_BITMAP, MFT_SEPARATOR, or MFT_STRING values.
cch
Length of the
menu item text, when information is received about a menu item of the
MFT_STRING type. This value is zero for other menu item types. This member is
ignored when the content of a menu item is set.
Remarks
The MENUITEMINFO
structure is used with the GetMenuItemInfo, InsertMenuItem, and SetMenuItemInfo
functions.
See Also