MENUITEMINFO结构体说明

来源：互联网发布：2017网络热点词汇编辑：程序博客网时间：2024/05/16 13:55

声明:转载此文档时请注意转载来源和我的名字,本人水平有限翻译有误处请指出

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成员设置