类WindowXp (CYisongStartMenu)开始菜单 编程指南

本菜单实现环境为VC6.0，其功能基本上和WindowXp 和Vista 操作系统的开始菜单一样，界面非常精美，通过编程能实现风格多样，具有个性化的功能菜单。

 

YisongStartMenu开始菜单有如下主要特点：

1. 在C＋＋环境实现，界面风格可实现自定义
2. 不仅适用Mouse 操作，还支持响应按键功能。
3. 可显示Left Bar 并定义其风格
4. 可自定义焦点亮条的风格
5. 可设置菜单子项为Check Option 风格

1．文件说明

 

类文件：MyStartMenu.h 、MyStartMenu.cpp (CyisongStartMenu 开始菜单类)

                MyToolTipCtrl.h,  MyToolTipCtrl.cpp(CmyToolTipCtrl 提示消息类)

其它文件：结构常量定义文件

 

2．CYisongStartMenu 用法

1. 定义一变量：CYisongStartMenu  m_StartMenu;

 

2. 在.cpp文件中现实代码

//主菜单初始化过程

      _TextInfo textInfo;        /定义主菜顶部文本信息结构

m_StartMenu.GetUserPaneTextInfo(textInfo);//获取文本信息的初始属性

      textInfo.clrShadow = GetSysColor(COLOR_BTNSHADOW);//设文本信息的主要属性

      textInfo.nOffsetX = 1;

      textInfo.nOffsetY = 1;

      textInfo.logFontUserText.lfItalic = TRUE;

m_StartMenu.SetUserPaneTextInfo(textInfo); //使设置有效

m_StartMenu.SetUserPaneText(_T("WindowXp Menu")); //设置主菜顶部标题

m_StartMenu.SetUserPaneIcon(IDI_ICON_QQ,CSize(48,48)); //设置主菜顶部显示图标

//设置主菜顶部显示图形

m_StartMenu.GetUserBitmap(0,".//skin//1.bmp");

m_StartMenu.GetUserBitmap(1,".//skin//2.bmp");

m_StartMenu.GetUserBitmap(2,".//skin//3.bmp");

//实现菜单菜项的添加(左边主程序项的添加)

m_StartMenu.AppendProgItem(_T("Internet/nInternet Explorer"), ID_PROGLIST_IE,0,

MENU_DEFAULT,IDI_ICON_IE,NULL,_T("联接国际互际联网页"));

m_StartMenu.AppendProgItem(….)

      ….

m_StartMenu.AppendProgItem(_T("所有程序"),IDR_MENU_TEST,0,

MENU_BOTTOM|MENU_POPUP,0,NULL,NULL,&m_wndSubMenu);

//实现菜单菜项的添加(右边一般菜单子项的添加)

//和上面方法一样，只不过是用函数AppendProgItem()

 

m_StartMenu. AppendPlaceItem(_T("My Documents"),

ID_PLACELIST_MYDOCUMENT,0,MENU_DEFAULT,

IDI_ICON_MYDOCUMENT);

             …..

m_StartMenu. AppendPlaceItem(….);

//设置菜单子项文本颜色, PLACELIST_TYPE指Place List 子项颜色 //PROGLIST_TYPE 指Prog List(左边列表)子项颜色

m_StartMenu.SetItemTextColor(PLACELIST_TYPE,RGB(0,255,0));

 

//设置子项有焦点时，其显示的亮条图形，不设置亮条为蓝色

m_StartMenu.SetItemFoucsBitmap(PLACELIST_TYPE,".//skin//OverFoucs.bmp")

 

 

//设置菜单底部属性

CImageList lst;

lst.Create(IDB_STARTPANE_BUTTONS,24,3,RGB(192,192,192));

HICON hIconTurnOff = lst.ExtractIcon(2);

m_StartMenu.AppendBottomItem(_T("Turn Off Computer"),

ID_BOTTOMBAR_TURNOFFCOMPUTER,

0,MENU_NORMAL,0,hIconTurnOff);

HICON hIconLogOff = lst.ExtractIcon(1);

m_StartMenu.AppendBottomItem(_T("Log Off"),ID_BOTTOMBAR_LOGOFF,

0,MENU_NORMAL,0,hIconLogOff);

 

            //设置菜单底部显的背景图形。

            m_StartMenu.GetBottomBarBitmap(0,".//skin//1.bmp");

            m_StartMenu.GetBottomBarBitmap(1,".//skin//2.bmp");

            m_StartMenu.GetBottomBarBitmap(2,".//skin//3.bmp");

     

…..

 

3. 显示菜单方法

//空口中在某点(x,y)处显示，作为m_hWnd 的子窗口

      m_StartMenu.TrackPopPane(point.x, point.y, m_hWnd, 0);

 

 

4. 响应菜单菜单命令

在用AppendPlaceItem()或AppendProgItem()、AppendBottomItem()添加菜单子项时

它们第二个参数为菜单项的ID。在响应每个子项mouse 单击事件时，会向菜单其父窗口发送WM_COMMAND消息，

::SendMessage(m_hWndParent,WM_COMMAND,m_pCurrentItem->uID,0)

 

      所以只要在主窗口为每个菜单项映谢消息ON_COMMAND的函数函行了，方法是

在cpp文件中找到消息息映射处( 在BEGIN_MESSAGE_MAP(CWindowsXPMenuDlg, CDialog) 和END_MESSAGE_MAP()之间)。添加如下代码：

 

ON_COMMAND(ID_MENUITEM，OnFunc)

 

在.h头文件对OnFunc()函数声明为消息函数：

 

afx_msg void OnFunc()；

 

      在OnFunc()函数中实现菜单项的命令的功能

二．主要功能接口函数的说明

 

 

1．函数名：AppendProgItem()

功    能：添加主程序功能菜单项

原型及参数说明：

void AppendProgItem(LPCTSTR szItemName,

   UINT uID,

   ULONG ulData,

   UINT uFlags,

   UINT uIconResID,

   HICON hIcon = NULL,

   LPCSTR szTooltip=_T(""),

   CYisongStartMenu* pSubMenu = NULL);

szItemName：菜单项文本标题

uID：菜单项ID标识

ulData: 保留

uFlags: 菜单风格定义，其值可为下列值或组合

 

MENU_NORMAL    ：普通风格

MENU_DEFAULT    ：默认风格,和普通风格其本一样，但字体为粗体          

MENU_SEPARATOR：作为分隔条         

MENU_GRAY           ： 灰色          

MENU_DISABLE       ：禁止           

MENU_ENABLE        ：使能           

MENU_CHECKED    ：带检查标志           

MENU_UNCHECKED：去检查标志         

           

MENU_HILITE        ：有高亮条   

MENU_POPUP         ：有弹出子菜单                   

MENU_BOTTOM    ：主程序项(象开始菜单的[所有程序]

 

            uIconResID：菜单项前面的图标ID ，其值为0时 图标会由参数hIcon指定，若hIcon

                                    也为NULL，则不显示图标。

            hIcon：            菜单项前面的图标句柄，初始为NULL

            szTooltip：      提示信息文本。

            PSubMenu：   为该菜单项指定的子菜单。初始为NULL

 

           

如显示为分隔条的方法是：

AppendProgItem(_T(""),0,0,MENU_SEPARATOR,0);

或

AppendPlaceItem(_T(""),0,0,MENU_SEPARATOR,0);

 

        与本功能相同用的函数还有AppendPlaceItem()，用法上完全一样。

2．函数名：SetProgItemBackColor()

功    能：设置菜单列表背景颜色

原型及参数说明：

void SetProgItemBackColor(COLORREF clrLeftTop,

    COLORREF clrRightBottom,

    bool bValid)

 

 

      clrLeftTop：左上角的颜色

      clrRightBottom：右下角结束处   颜色

bValid：布尔型变量，TRUE，表示立即设置生效。

 

说明：SetProgItemBackColor()函数的用法及功能与本函是一样的，请参照此用法。

 

3．函数名：SetItemTextColor(ITEM_TYPE nType,COLORREF clrText)

功   能：设置菜单文本颜色

原型及参数说明：

      void  SetItemTextColor(ITEM_TYPE nType,COLORREF clrText)

 

nType :ITEM_TYPE枚举类型的数参

 

 enum ITEM_TYPE

{

      PROGLIST_TYPE,                 //指Program 列表菜单

      PLACELIST_TYPE,               //指Place 列表菜单

      BOTTOMBAR_TYPE,           //菜单底部

 }

 

clrText：本文的颜色

设置 Program 列表菜单项的文本颜色为 红色的方法如下：

      Exp.:   SetItemTextColor(PROGLIST_TYPE, RGB(255,0,0));

注意：一般在菜单初始完成后调用该函数来设置菜单项的文本颜色。

     

            4．函数名：GetBottomBarBitmap()

                  功  能：设置菜单底部背景图象

      原型及参数说明：void GetBottomBarBitmap(int nMode,LPTSTR szFile))

nMode ：指出显示方式

szFile ：  图像文件及路径。

     与些函数功能相同的还有GetUserBitmap(int nMode,LPTSTR szFile)

5．函数名：SetAsSubMenu()

功   能：设置菜单为弹出(子)菜单

原型及参数说明：void SetAsSubMenu(BOOL bSubmenu)

bSubmenu ＝TRUE时，表示为弹出(子)菜单。如上图的 TEST菜单

 

6．函数名：SetItemFoucsBitmap(ITEM_TYPE nType,LPTSTR strFile)

                  功   能：  设置菜单项的焦点高亮显示方式

原型及参数说明：void SetItemFoucsBitmap(ITEM_TYPE nType,LPTSTR strFile)

 

nType：参考上面介始   

                  strFile：焦点高亮显示图形，为NULL  则显示默认的高亮条

 

                   注意：一般在菜单初始完成后调用该函数