自绘菜单
下载本文源代码
应用程序中的菜单，在界面中占据了重要位置，它的效果如何，直接影响了整个程序的界面效果，正因为这个原因，当今流行的应用程序的菜单都支持附带图标、反映当前状态的功能，也就是说，菜单项上不再仅仅有文字，还有附带一个小小的图标，同时在用户操作菜单时，菜单能够以不同的状态反映用户的操作，这些功能的实现，可以大大，美化程序界面，增强程序的吸引力。
Visual C++为开发人员提供了应用程序自动生成方法，使开发人员可以避开繁琐的界面开发，专著于各种功能的具体实现。虽然这种自动生成应用程序框架的手段方便了初级程序设计人员，但是它也有着先天的不足，那就是通过这种手段生成的应用程序界面比较简单，不适宜应用程序的推广。对于Visual C++自动生成的框架程序，要实现菜单的上述功能，唯一的办法就是通过菜单自绘的手段来实现，本例将通过实现CMenu类的子类CmenuEx类，详细介绍了如何编程实现菜单的自绘，使应用程序中的菜单也可以拥有图标，并且能够反映用户的不同操作，下图为程序编译运行后的效果：
一、实现方法：
要实现漂亮的界面菜单，必须要启动菜单项的自绘功能，所谓菜单的自绘，就是让菜单自己管理自己的显示效果，为此，首先要作的就是设置菜单项的风格为MF_OWNERDRAW（自绘制），设置菜单的自绘功能即可以通过CMenu类的AppendMenu（）函数在菜单的初始阶段实现，也可以通过ModifyMenu（）函数对已存在的菜单项进行类型修改。
具体的菜单的自绘是通过重载CMenu类的DrawItem（）函数来实现的，这个函数根据各种菜单状态，处理当前菜单项中菜单图标、文字显示的功能。DrawItem（）函数的原形为：virtual void DrawItem( LPDRAWITEMSTRUCT lpDrawItemStruct )，它参数为一个指向DRAWITEMSTRUCT结构的指针，DRAWITEMSTRUCT结构如下：
可以看出，上面的DRAWITEMSTRUCT结构包含了控件自绘时的各种信息。
其中，结构成员CtlType指定了控件的类型，其取值ODT_BUTTON表示按钮控件；ODT_COMBOBOX表示组合框控件；ODT_LISTBOX表示列表框控件；ODT_LISTVIEW表示列表视图控件；ODT_MENU菜单项；ODT_STATIC表示静态文本控件；ODT_TAB表示Tab控件。CtlID指定了自绘控件的ID值，而对于菜单项则不需要使用该成员。itemID表示菜单项ID，也可以表示列表框或者组合框中某项的索引值，对于一个空的列表框或组合框，该成员的值为-1。
itemAction指定绘制行为，其取值可以为下表中所示值的一个或者多个的联合：ODA_DRAWENTIRE表示整个控件都需要被绘制；ODA_FOCUS表示控件需要在获得或失去焦点时被绘制；ODA_SELECT表示控件需要在选中状态改变时被绘制。
itemState指定了当前绘制操作时所绘项的状态，例如，如果菜单项应该被灰色显示，则可以指定ODS_GRAYED状态标志。其取值可以为下表中所示值的一个或者多个的联合：ODS_CHECKED表示菜单项将被选中，该值只对菜单项有用；
ODS_COMBOBOXEDIT在自绘组合框控件中只绘制选择区域；
ODS_DEFAULT表示当前控件处于默认状态；
ODS_DISABLED表示控件将被禁止；
ODS_FOCUS表示控件需要输入焦点；
ODS_GRAYED表示控件需要被灰色显示，该值只在绘制菜单时使用；
ODS_HOTLIGHT表示鼠标指针位于控件之上时控件会显示高亮颜色（支持Windows 98/Me, Windows 2000/XP）；
ODS_SELECTED表示选中控件；hwndItem 指定了组合框、列表框和按钮等自绘控件的窗口句柄；如果自绘的对象时菜单项，则表示包含该菜单项的菜单句柄。hDC指定了绘制操作所使用的设备环境。 rcItem指定了将被绘制的矩形区域。这个矩形区域就是上面hDC的作用范围。系统会自动裁剪组合框、列表框或按钮等控件的自绘制区域以外的部分。也就是说rcItem中的坐标点（0，0）指的就是控件的左上角。但是系统不裁剪菜单项，所以在绘制菜单项的时候，必须先通过一定的换算得到该菜单项的位置，以保证绘制操作在我们希望的区域中进行。
itemData这个成员变量最为关键，菜单自绘时所需要的图标、文本等信息都是通过它获取的，至于它的具体值，是通过CMenu类的CMenu::AppendMenu（）、CMenu::InSertMenu（）、CMenu::ModifMenu（）等函数的调用来传递的。
菜单自绘仅仅重载CMenu::DrawItem（）函数是不够的，还需要重载CMenu:: MeasureItem（）函数，在这个函数里面填充MEASUREITEMSTRUCT结构，通知Windows自绘控件的尺寸。该函数的原形为：
该函数的参数为一个指向MEASUREITEMSTRUCT结构的指针对象，该对象结构为：
上面这个结构中，成员变量CtlType等于ODT_COMBOBOX 时，表示当前控件为自绘型的组合框，等于ODT_LISTBOX 时表示当前控件为自绘列表控制件，等于ODT_MENU 时表示当前控件为自绘菜单。对于组合框和列表框控件，成员变量itemData是通过相应的AddString（）、InsertString（）获取的， 对于菜单控件，成员变量itemData与DRAWITEMSTRUCT结构中的itemData是一致的。
菜单自绘时所需要的图标资源，可以预先定义，使用时直接装载，但是这种方法比较呆板，另外一种方法是通过搜索状态条上的按钮信息，如果当前按钮的ID识别号与某一菜单项的ID识别号一致，那末通过就将该按钮上的图标提取出来，作为菜单图标，如果菜单项与工具条上的所有按钮的ID都不相同，那么对该菜单项不画图标。至于菜单的文本信息，直接采用用户自定义菜单的文本就可以了。
根据上面介绍的知识，本例定义一个CMemu类的子类CMemuEx类来实现菜单的自绘功能，该类不仅支持在菜单中显示图标、即时反映当前菜单项状态的功能，还支持在菜单中添加纵向位图。在具体实现过程中，CMemuEx类除了上述介绍的需要重载的DrawItem（）、MeasureItem（）等函数外，另外的一些主要成员函数如下：
1、void InitMenu(CMenu *pMenu,UINT uToolBar,CToolBar *pToolBar);
说明：这是CMenuEx类最主要的一个接口。该函数根据状态栏信息来初始化CMenuEx类；
2、void SetImageLeft(UINT idBmpLeft)；
说明：这也是CMenuEx类中的一个重要的接口。调用CMenuEx类对象的SetImageLeft（）可以实现菜单中的纵向位图(像Windows系统中的"开始"菜单)，调用该函数时参数是位图的ID值。需要注意的是，目前CMenuEx类实现的是对主框架菜单设置纵向位图，对上下文菜单不适用，读者朋友可以稍加修改，自由的决定对何种菜单设置纵向位图。
3、void InitPopupMenu(CMenu *pMenu,UINT uToolBar,CToolBar *pToolBar)
说明：这个函数是为了处理上下文菜单的自绘而编写的，CMenuEx类的任一实例都只能调用InitMenu（）、InitPopupMenu（）这两个成员函数中的一个，不能一同使用。
4、int GetImageFromToolBar(UINT uToolBar, CToolBar *pToolBar,COLORREF crMask)
说明：这个函数用来从工具条上获取相应图标。
5、void ChangeStyle(CMenu *pMenu,CToolBar *pToolBar,BOOL bIsMainMenu)
说明：这个函数用来修改菜单pMenu的类型为"自绘制"
6、void DrawMenuItemImage(CDC *pDC,CRect &rect,BOOL bSelected,BOOL bChecked,BOOL bGrayed,BOOL bHasImage,LPMENUITEM lpItem);
说明：这个函数根据菜单的不同状态及包含的各种信息，对菜单进行绘制；
上述函数构成了CMenuEx类的主要骨架，该类还有一些实现辅助函数，它们分别是：
1、void SetHighLightColor(COLORREF crColor); //设置菜单搞亮显示；
2、void SetBackColor(COLORREF); //设置菜单的背景颜色；
3、void SetTextColor(COLORREF); //设置菜单的文本颜色；
4、void GrayString(CDC *pDC,const CString &str,const CRect rect); //显示灰色菜单文本；
5、void TextMenu(CDC *pDC,CRect &rect,CRect rtText,BOOL bSelected,BOOL bGrayed,LPMENUITEM lpItem); //显示菜单上的文本；
CMenuEx类在使用过程中，要注意对其初始化，对于主框架菜单，可以在CMainFrame类的WM_INITMENU消息响应函数中实现，为了激活菜单的自绘功能， 需要在CMainFrame类的WM_DRAWITEM和WM_MEASUREITEM中分别调用CMenuEx类的DrawItem（）函数和MeasureItem（）函数。对于上下文菜单的实现，有两种方法，一种方法是在项目视图类的WM_INITMENUPOPUP响应函数中调用InitPopupMenu（）函数来修改菜单的类型，然后在WM_CONTEXTMENU响应函数中调用CMenu::TrackPopupMenu（）函数显示上下文菜单；另一种方法是直接响应鼠标的右键单击消息，在响应函数中处理鼠标的初始化和显示。第二种方法处理上下文菜单比较常用，这方面的资料也很多，就不在赘述了。为了让读者朋友们更深入的了解上下文菜单的处理，例子中使用了第一种方法。
应用程序中的菜单，在界面中占据了重要位置，它的效果如何，直接影响了整个程序的界面效果，正因为这个原因，当今流行的应用程序的菜单都支持附带图标、反映当前状态的功能，也就是说，菜单项上不再仅仅有文字，还有附带一个小小的图标，同时在用户操作菜单时，菜单能够以不同的状态反映用户的操作，这些功能的实现，可以大大，美化程序界面，增强程序的吸引力。
Visual C++为开发人员提供了应用程序自动生成方法，使开发人员可以避开繁琐的界面开发，专著于各种功能的具体实现。虽然这种自动生成应用程序框架的手段方便了初级程序设计人员，但是它也有着先天的不足，那就是通过这种手段生成的应用程序界面比较简单，不适宜应用程序的推广。对于Visual C++自动生成的框架程序，要实现菜单的上述功能，唯一的办法就是通过菜单自绘的手段来实现，本例将通过实现CMenu类的子类CmenuEx类，详细介绍了如何编程实现菜单的自绘，使应用程序中的菜单也可以拥有图标，并且能够反映用户的不同操作，下图为程序编译运行后的效果：
 图一、自绘菜单实现后的效果图 |
一、实现方法：
要实现漂亮的界面菜单，必须要启动菜单项的自绘功能，所谓菜单的自绘，就是让菜单自己管理自己的显示效果，为此，首先要作的就是设置菜单项的风格为MF_OWNERDRAW（自绘制），设置菜单的自绘功能即可以通过CMenu类的AppendMenu（）函数在菜单的初始阶段实现，也可以通过ModifyMenu（）函数对已存在的菜单项进行类型修改。
具体的菜单的自绘是通过重载CMenu类的DrawItem（）函数来实现的，这个函数根据各种菜单状态，处理当前菜单项中菜单图标、文字显示的功能。DrawItem（）函数的原形为：virtual void DrawItem( LPDRAWITEMSTRUCT lpDrawItemStruct )，它参数为一个指向DRAWITEMSTRUCT结构的指针，DRAWITEMSTRUCT结构如下：
| typedef struct tagDRAWITEMSTRUCT { UINT CtlType; //控件类型； UINT CtlID; //组合框、列表框等控件的ID标识号； UINT itemID; //菜单项的ID标识号或列表框、组合框中某一项的索引值； UINT itemAction; //控件行为； UINT itemState; //控件状态； HWND hwndItem; //父窗口句柄或菜单句柄 HDC hDC; //控件对应的绘图设备句柄 RECT rcItem; //控件所占据的矩形区域 DWORD itemData; //列表框或组合框中某一项的值 } |
可以看出，上面的DRAWITEMSTRUCT结构包含了控件自绘时的各种信息。
其中，结构成员CtlType指定了控件的类型，其取值ODT_BUTTON表示按钮控件；ODT_COMBOBOX表示组合框控件；ODT_LISTBOX表示列表框控件；ODT_LISTVIEW表示列表视图控件；ODT_MENU菜单项；ODT_STATIC表示静态文本控件；ODT_TAB表示Tab控件。CtlID指定了自绘控件的ID值，而对于菜单项则不需要使用该成员。itemID表示菜单项ID，也可以表示列表框或者组合框中某项的索引值，对于一个空的列表框或组合框，该成员的值为-1。
itemAction指定绘制行为，其取值可以为下表中所示值的一个或者多个的联合：ODA_DRAWENTIRE表示整个控件都需要被绘制；ODA_FOCUS表示控件需要在获得或失去焦点时被绘制；ODA_SELECT表示控件需要在选中状态改变时被绘制。
itemState指定了当前绘制操作时所绘项的状态，例如，如果菜单项应该被灰色显示，则可以指定ODS_GRAYED状态标志。其取值可以为下表中所示值的一个或者多个的联合：ODS_CHECKED表示菜单项将被选中，该值只对菜单项有用；
ODS_COMBOBOXEDIT在自绘组合框控件中只绘制选择区域；
ODS_DEFAULT表示当前控件处于默认状态；
ODS_DISABLED表示控件将被禁止；
ODS_FOCUS表示控件需要输入焦点；
ODS_GRAYED表示控件需要被灰色显示，该值只在绘制菜单时使用；
ODS_HOTLIGHT表示鼠标指针位于控件之上时控件会显示高亮颜色（支持Windows 98/Me, Windows 2000/XP）；
ODS_SELECTED表示选中控件；hwndItem 指定了组合框、列表框和按钮等自绘控件的窗口句柄；如果自绘的对象时菜单项，则表示包含该菜单项的菜单句柄。hDC指定了绘制操作所使用的设备环境。 rcItem指定了将被绘制的矩形区域。这个矩形区域就是上面hDC的作用范围。系统会自动裁剪组合框、列表框或按钮等控件的自绘制区域以外的部分。也就是说rcItem中的坐标点（0，0）指的就是控件的左上角。但是系统不裁剪菜单项，所以在绘制菜单项的时候，必须先通过一定的换算得到该菜单项的位置，以保证绘制操作在我们希望的区域中进行。
itemData这个成员变量最为关键，菜单自绘时所需要的图标、文本等信息都是通过它获取的，至于它的具体值，是通过CMenu类的CMenu::AppendMenu（）、CMenu::InSertMenu（）、CMenu::ModifMenu（）等函数的调用来传递的。
菜单自绘仅仅重载CMenu::DrawItem（）函数是不够的，还需要重载CMenu:: MeasureItem（）函数，在这个函数里面填充MEASUREITEMSTRUCT结构，通知Windows自绘控件的尺寸。该函数的原形为：
| virtual void MeasureItem( LPMEASUREITEMSTRUCT lpMeasureItemStruct ); |
该函数的参数为一个指向MEASUREITEMSTRUCT结构的指针对象，该对象结构为：
| typedef struct tagMEASUREITEMSTRUCT { UINT CtlType; //控件类型； UINT CtlID; //控件的ID识别号，它不包括菜单控件； UINT itemID; //菜单项的ID识别号； UINT itemWidth; //菜单项的宽度； UINT itemHeight; //菜单项的高度； DWORD itemData //自绘控件所需要的数据， } MEASUREITEMSTRUCT; |
上面这个结构中，成员变量CtlType等于ODT_COMBOBOX 时，表示当前控件为自绘型的组合框，等于ODT_LISTBOX 时表示当前控件为自绘列表控制件，等于ODT_MENU 时表示当前控件为自绘菜单。对于组合框和列表框控件，成员变量itemData是通过相应的AddString（）、InsertString（）获取的， 对于菜单控件，成员变量itemData与DRAWITEMSTRUCT结构中的itemData是一致的。
菜单自绘时所需要的图标资源，可以预先定义，使用时直接装载，但是这种方法比较呆板，另外一种方法是通过搜索状态条上的按钮信息，如果当前按钮的ID识别号与某一菜单项的ID识别号一致，那末通过就将该按钮上的图标提取出来，作为菜单图标，如果菜单项与工具条上的所有按钮的ID都不相同，那么对该菜单项不画图标。至于菜单的文本信息，直接采用用户自定义菜单的文本就可以了。
根据上面介绍的知识，本例定义一个CMemu类的子类CMemuEx类来实现菜单的自绘功能，该类不仅支持在菜单中显示图标、即时反映当前菜单项状态的功能，还支持在菜单中添加纵向位图。在具体实现过程中，CMemuEx类除了上述介绍的需要重载的DrawItem（）、MeasureItem（）等函数外，另外的一些主要成员函数如下：
1、void InitMenu(CMenu *pMenu,UINT uToolBar,CToolBar *pToolBar);
说明：这是CMenuEx类最主要的一个接口。该函数根据状态栏信息来初始化CMenuEx类；
2、void SetImageLeft(UINT idBmpLeft)；
说明：这也是CMenuEx类中的一个重要的接口。调用CMenuEx类对象的SetImageLeft（）可以实现菜单中的纵向位图(像Windows系统中的"开始"菜单)，调用该函数时参数是位图的ID值。需要注意的是，目前CMenuEx类实现的是对主框架菜单设置纵向位图，对上下文菜单不适用，读者朋友可以稍加修改，自由的决定对何种菜单设置纵向位图。
3、void InitPopupMenu(CMenu *pMenu,UINT uToolBar,CToolBar *pToolBar)
说明：这个函数是为了处理上下文菜单的自绘而编写的，CMenuEx类的任一实例都只能调用InitMenu（）、InitPopupMenu（）这两个成员函数中的一个，不能一同使用。
4、int GetImageFromToolBar(UINT uToolBar, CToolBar *pToolBar,COLORREF crMask)
说明：这个函数用来从工具条上获取相应图标。
5、void ChangeStyle(CMenu *pMenu,CToolBar *pToolBar,BOOL bIsMainMenu)
说明：这个函数用来修改菜单pMenu的类型为"自绘制"
6、void DrawMenuItemImage(CDC *pDC,CRect &rect,BOOL bSelected,BOOL bChecked,BOOL bGrayed,BOOL bHasImage,LPMENUITEM lpItem);
说明：这个函数根据菜单的不同状态及包含的各种信息，对菜单进行绘制；
上述函数构成了CMenuEx类的主要骨架，该类还有一些实现辅助函数，它们分别是：
1、void SetHighLightColor(COLORREF crColor); //设置菜单搞亮显示；
2、void SetBackColor(COLORREF); //设置菜单的背景颜色；
3、void SetTextColor(COLORREF); //设置菜单的文本颜色；
4、void GrayString(CDC *pDC,const CString &str,const CRect rect); //显示灰色菜单文本；
5、void TextMenu(CDC *pDC,CRect &rect,CRect rtText,BOOL bSelected,BOOL bGrayed,LPMENUITEM lpItem); //显示菜单上的文本；
CMenuEx类在使用过程中，要注意对其初始化，对于主框架菜单，可以在CMainFrame类的WM_INITMENU消息响应函数中实现，为了激活菜单的自绘功能， 需要在CMainFrame类的WM_DRAWITEM和WM_MEASUREITEM中分别调用CMenuEx类的DrawItem（）函数和MeasureItem（）函数。对于上下文菜单的实现，有两种方法，一种方法是在项目视图类的WM_INITMENUPOPUP响应函数中调用InitPopupMenu（）函数来修改菜单的类型，然后在WM_CONTEXTMENU响应函数中调用CMenu::TrackPopupMenu（）函数显示上下文菜单；另一种方法是直接响应鼠标的右键单击消息，在响应函数中处理鼠标的初始化和显示。第二种方法处理上下文菜单比较常用，这方面的资料也很多，就不在赘述了。为了让读者朋友们更深入的了解上下文菜单的处理，例子中使用了第一种方法。
