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, FAR *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消息
MFT_RADIOCHECK 如果hbmpChecked成员是NULL 显示选中的菜单项使用一个单选按钮来代替一个复选标记
MFT_RIGHTJUSTIFY 权利证明菜单项和所有后来的项,如果菜单项在菜单栏内这个值才是唯一有效的
MFT_RIGHTORDER Windows 95, Windows NT 5.0,和随后的:指定那个层叠菜单右至左(默认的是左
至右).这是支持习惯右至左的语言，这样的人是阿拉伯的和希伯来人
MFT_SEPARATOR 指定那个菜单项是一个隔离物(线条).一个菜单隔离物看起来是水平分划的线条.
dwTypeDate和cch成员忽视. 这个值在一个下拉菜单,子菜单,或快捷菜单才是唯一有效的
MFT_STRING 显示使用菜单项的一个文本字符串.dwTypeData成员指示一个空终止的字符串,和cch
成员是字符串的长度
MFT_BITMAP, MFT_SEPARATOR, and MFT_STRING 任何一个值都不能相互组合使用
fState
菜单项的状态.这个成员可以是一个或多个的这些值:
MFS_CHECKED 复选的菜单项.至于更多关于菜单项选中的信息,看hbmpChecked成员.
MFS_DEFAULT 指定那个是默认的菜单项。一个菜单仅仅只可以包含一个默认的菜单项,粗体显示那个。
MFS_DISABLED 禁止菜单项所以它不能被选择.但是不使它变灰.
MFS_ENABLED 激活菜单项所以它可以被选择。这是默认的状态.
MFS_GRAYED 禁止菜单项和变灰它，所以它不可以被选择.
MFS_HILITE 加亮菜单项
MFS_UNCHECKED 取消复选菜单项.至于更多关于菜单项unchecked信息，看hbmpUnchecked成员变量
MFS_UNHILITE 移除来自菜单项的加亮区.这是默认状态.
wID
应用程序定义16位的值来识别那个菜单项.
hSubMenu
下拉菜单或相关联的子菜单的菜单项的句柄。如果菜单项不是一个打开的下拉菜单或子菜单,那这个成员是NULL
hbmpChecked
如果条目被选中，这个显示项是位图的句柄.如果这个成员是NULL,使用一个默认的位图.如查
MFT_RADIOCHECK类型值是被指定的.这个默认的图片是子弹一样的图片。否则它是复选标记
hbmpUnchecked 如果条目没有被选中,这个显示项是位图的句柄,如果成员是NULL,不能使用位图
dwItemData
应用程序定义的菜单项相关联的值
dwTypeData
菜单项的内容.如果fMask成员设置了MIIM_TYPE标记这个成员才能被使用;
在调用GetMenuItemInfo之前.应用程序必须为这个成员设置一个指定的缓冲区.长度是cch成员指
定.如果取回的菜单项的类型是MFT_STRING，那么GetMenuItemInfo 拷贝菜单项的文本到缓冲区.如果取回
的菜单项是其它类型,那么GetMenuItemInfo设置dwTypeDate一个值,是fType成员指定的
在使用SetMenuItemInfo函数的时候,谁包含这个成员类型的一个值，是fType成员指定.
cch
菜单项文本的长度息，就在一个菜单项的类型是MFT_STRING信息时.如果fMask成员设置
MIIM_TYPE标记和没有其它方面的这个成员是唯一可以使用的.在调用SetMenuItemInfo设置菜单项的内容
时这个成员忽略.在调用GetMenuItemInfo前,应用程序必须为dwTypeDate成员设置一个指定长度的缓冲区.如果取回的菜单
项类型是MFT_STRING(fType成员被指定),那么GetMenuItemInfo设置cch为取回字符串的长度.如果取回的菜单项
是其它类型,GetMenuItemInfo把cch设置为0
说明
MENUITEMINFO 结构体可以被GetMenuItemInfo, InsertMenuItem, and SetMenuItemInfo 函数使用