VC MFC工具栏(CToolBar)控件

工具栏

工具栏控件在控件面板里没有对应的选项（图标），但有一个工具栏控件类CToolBar,所以我们如果要创建一个工具栏控件并显示在窗口里的话，只能用代码来完成，事实上任何一种控件，都可以用代码创建，如CButton按钮类，现举一个用代码创建按钮控件并显示在窗口里的例子。

CButton类的Create成员函数可以创建一个按钮控件，这个函数的格式如下：
BOOL CButton::Create(
     LPCTSTR lpszCaption,//按钮显示的文本
     DWORD dwStyle,//按钮样式
     const RECT& rect,//按钮控件显示的区域（大小）相对于父窗口
     CWnd* pParentWnd,//按钮的父窗口(按钮属于哪个窗口）
     UINT nID//指明按钮控件ID号

    );
这个函数的第二个参数dwStyle是按钮控件的样式，也就是在可视化添加按钮控件时，右击按钮控件，选择属性，之后会弹出一个对话框，这个对话框有一个样式的选项，该参数即对应这个样式。

好了，了解了上面这些我们就来动态创建一个按钮吧，首先在对应话类里添加一个按钮类成员变量CButton m_Button;

然后在对话框编辑区里给对话框添加一个按钮控件（单击这个按钮创建按钮控件）,然后添加这个按钮控件单击消息处理函数，并在函数添加以下语句：

 RECT ButtonRect;//按钮控件显示的区域（大小）相对于父窗口
 ButtonRect.left=10;
 ButtonRect.top=10;
 ButtonRect.right=80;
 ButtonRect.bottom=30;
 m_Button.Create("动态创建",WS_CHILD,ButtonRect,this,1115);
 m_Button.ShowWindow(SW_SHOW);//显示按钮控件

知道了怎样动态创建按钮控件，我们就来创建工具栏控件。

首先在对话类中添加一个CToolBar类成员变量CToolBar m_Toolbar;

然后在对话类文件中定义工具栏命令ID

#define ID_BUTTON1    501
#define ID_BUTTON2    502
#define ID_BUTTON3    503

接着我们就要创建工具栏资源了，用于工具栏按钮的显示图片

方法是进入ResourceView(资源视图选项卡），再随便选中一个选项，右击选择插入，在弹出的对话框里选中Toolbar，点新建。

接着创建三个按钮。如下图所示：

好了，下面把三个按钮ID号，改成上面宏定义的ID号，如果要改变“天”字按钮，选中该按钮，然后回车键，就会弹出一个对话框，

在ID项填入ID_BUTTON1，就可以了。接着依次把两个ID号改为ID_BUTTON2，ID_BUTOON3。在这个对话框里也可以改变工具栏按钮的大小。

接下来我们样在对话框类的OnInitDialog函数里的所有代码之后，return TRUE;之间添加以下语句：
     m_Toolbar.Create(this);//创建工具栏控件
     m_Toolbar.LoadToolBar(IDR_TOOLBAR1);//装载工具栏资源
  CRect rect(100,100,200,200);//
  m_Toolbar.MoveWindow(rect);//移动工具栏在父窗口的位置
  m_Toolbar.ShowWindow(SW_SHOW);//显示工具栏

但这样显示工具栏不是很方便，特别是当窗口大小改变后，还要计算工具栏在窗口中的位置，有没有什么方法，可以根据窗口大小自动调整工具栏到合适的位置呢？答案是肯定的，RepositionBars函数可以做到。实现方法如下，把上面的语句换成下面的：

  m_Toolbar.Create(this);//创建工具栏控件
    m_Toolbar.LoadToolBar(IDR_TOOLBAR1);//装载工具栏资源
  //该函数用于显示工具栏，并根据窗口大小自动调整工具栏的位置
  RepositionBars(AFX_IDW_CONTROLBAR_FIRST,AFX_IDW_CONTROLBAR_LAST,0);

 而响应工具栏按钮单击消息，跟前面介绍的添加按钮单击消息差不多，进入类向导，找到要添加的工具栏按钮ID，添加COMMAND消息响应函数，如下图：

工具栏按钮上显示真彩位图

上面的例子有一个缺陷，那就是工具栏按钮显示的图形，不能超过256色，如果我想在工具栏按钮显示真彩位图，上面的方法显示是无法实现的，那这个功能是如何实现呢？

SetImageList函数可以做到，既然要显示真彩位图，那就不能使用上面的工具栏资源（256色），所以一切都得到用代码实现

 首先向工程引入六张位图（用于工具栏按钮显示的图片），假设ID号分别为IDB_BITMAP1，IDB_BITMAP2，IDB_BITMAP3,IDB_BITMAP4,IDB_BITMAP5,IDB_BITMAP6，大小为50X38

第一步：在对话框里添加两个成员变量分别是：

  CToolBar m_Toolbar;
  CImageList m_ImageList;

第二步：在对话类文件添加以下宏定义：
#define ID_BUTTON1    501
#define ID_BUTTON2    502
#define ID_BUTTON3    503
#define ID_BUTTON4    504
#define ID_BUTTON5    505
#define ID_BUTTON6    506

接下来在对话框初始化函数OnInitDialog后面添加如下语句：

m_ImageList.Create(50,38,ILC_COLOR24|ILC_MASK,1,1);//图片大小必须一致
  CBitmap bmp;
  for(int i=0;i<6;i++)
  {
   bmp.LoadBitmap(IDB_BITMAP1+i);
   m_ImageList.Add(&bmp,RGB(255,255,255));
   bmp.DeleteObject();
  }
  UINT nArray[6];
  for(i=0;i<6;i++)
  {
   nArray[i]=ID_BUTTON1+i;
  }
     m_Toolbar.CreateEx(this);//创建工具栏控件,CreateEx函数创建的工具栏，默认有浮动按钮属性
  m_Toolbar.SetButtons(nArray,6);//创建六个工具按钮，并依次设置ID号，对应nArray数组的元素
  m_Toolbar.SetSizes(CSize(60,56),CSize(50,38));//函数第一个是按钮大小，第二个是图像大小，按钮必须比图像要大，具体是按钮的要

     //比图像的宽大7或者以上，高6
  m_Toolbar.GetToolBarCtrl().SetImageList(&m_ImageList);//设置图像
  RepositionBars(AFX_IDW_CONTROLBAR_FIRST,AFX_IDW_CONTROLBAR_LAST,0);

运行效果如下图：

 如果要响应工具栏按钮单击消息的话，必须手动添加消息映射：如

 ON_COMMAND(ID_BUTTON1,Button1)   //button1为消息处理函数

如果要设置按钮显示文本的话，就是CToolBar类的 SetButtonText函数。

设置工具栏背景位图

用CReBar类可以实现在工具栏背景里显示位图，可以把工具栏设置成CReBar类对应的子窗口，以上面的工程为例子，再在对话类里添加一个成员变量： CReBar m_Rebar;接着导入一张位图，用做工具栏的背景，ID号为ID_TOOLBACK，然后在OnInitDialog函数的

RepositionBar(AFX_IDW_CONTROLBAR_FIRST,AFX_IDW_CONTROLBAR_LAST,0);语句前面添加如下语句：
m_Rebar.Create(this);//创建窗口（控件）
  m_Rebar.AddBar(&m_Toolbar);//添加m_Toolbar为子窗口
  m_Rebar.RedrawWindow();//重画窗口
  REBARBANDINFO info;
  info.cbSize=sizeof(info);
  info.fMask=RBBIM_BACKGROUND;
  m_Toolbar.ModifyStyle(0,TBSTYLE_TRANSPARENT);//设置工具栏背景色透明
  info.hbmBack=LoadBitmap(AfxGetInstanceHandle(),MAKEINTRESOURCE(IDB_TOOLBACK));//加载位图
  m_Rebar.GetReBarCtrl().SetBandInfo(0,&info);

编译，运行效果如下：

为工具栏按钮添加鼠标停留提示信息

以上面的工程为例子，在对话类里添加一个成员变量CString str;

接着在m_Toolbar调用CreateEx函数后，调用这个语句：  m_Toolbar.EnableToolTips();//激活信息提示功能

然后在对话类里添加一个成员函数（用于TTN_NEEDTEXT消息处理函数），格式如下：

BOOL  OnDisplay(UINT id, NMHDR *pNMHDR, LRESULT *pResult)

然后添加TTN_NEEDTEXT消息映射宏

 ON_NOTIFY_EX(TTN_NEEDTEXT,0,OnDisplay)

OnDisplay函数代码如下：

TOOLTIPTEXT *pTTT=(TOOLTIPTEXT *)pNMHDR;
UINT nID=pNMHDR->idFrom;//获取工具栏按钮ID
UINT nIndex=m_Toolbar.CommandToIndex(nID);//根据按钮ID获取索引
str.Format("工具栏按钮%d",nIndex);
pTTT->lpszText=str.GetBuffer(str.GetLength());//设置按钮提示信息
pTTT->hinst=AfxGetResourceHandle();
return TRUE;

工具栏按钮上显示图标

在按钮上显示图标，方法跟显示位图差不到哪去，只要让CImageList里添加的是图标就行了，首先向工程引入六个图标，假设ID号分别为IDI_ICON1、IDI_ICON2....IDI_ICON6

以上面的工程为例：在OnInitDialog函数最后添加如下代码：

m_ImageList.Create(48,48,ILC_COLOR24|ILC_MASK,1,1);//图片大小必须一致
 for(int i=IDI_ICON1;i<=IDI_ICON6;i++)
   m_ImageList.Add(AfxGetApp()->LoadIcon(i));//添加图标

  UINT nArray[6];
  for(i=0;i<6;i++)
  {
   nArray[i]=ID_BUTTON1+i;
  }
     m_Toolbar.CreateEx(this);//创建工具栏控件
  m_Toolbar.EnableToolTips();//激活信息提示功能
  m_Toolbar.SetButtons(nArray,6);
  m_Toolbar.SetSizes(CSize(60,56),CSize(48,48));
  m_Toolbar.GetToolBarCtrl().SetImageList(&m_ImageList);
  m_Rebar.Create(this);
  m_Rebar.AddBar(&m_Toolbar);
  m_Rebar.RedrawWindow();
  REBARBANDINFO info;
  info.cbSize=sizeof(info);
  info.fMask=RBBIM_BACKGROUND;
  m_Toolbar.ModifyStyle(0,TBSTYLE_TRANSPARENT);//设置工具栏背景色透明
  info.hbmBack=LoadBitmap(AfxGetInstanceHandle(),MAKEINTRESOURCE(IDB_TOOLBACK));
  m_Rebar.GetReBarCtrl().SetBandInfo(0,&info);
  RepositionBars(AFX_IDW_CONTROLBAR_FIRST,AFX_IDW_CONTROLBAR_LAST,0);

运行效果如下：

设置工具栏按钮热点图片

像前面的SetImageList函数设置工具栏按钮正常显示时的图片，而SetHotImageList函数是设置工具热点按钮图片，也就是当鼠标停留在按钮上所显示的图片，用法跟SetImageList函数一样，只是CImageList类关联的图片不一样。

为了显示热点按钮图片，我们得准备两组图片，一组用于正常显示，一组用于热点显示。这里我的图片格式是图标。还有一点要说明的是，工具栏必须具有TBSTYLE_FLAT（浮动按钮）属性，这一点在用CreateEx函数创建工具栏的时候，已经默认包含了。

两组图片：

正常显示：

热点显示：

工具栏背景位图：

首先向工程引入这十二个图标：假设正常显示的图标ID号依次为：IDI_NORMAL1、IDI_NORMAL2、。。。IDI_NORMAL6

热点图标ID依次为：IDI_HOT1、IDI_HOT2、。。。IDI_HOT6

然后引入背景位图，ID号为IDB_TOOLBACK

做完了这些，我们就向对话类里添加四个成员变量： 

 CToolBar m_Toolbar;
  CImageList m_ImageList;
  CImageList m_hotImageList;

 CReBar m_Rebar;

然后增加五个宏定义：

#define ID_BUTTON1    501
#define ID_BUTTON2    502
#define ID_BUTTON3    503
#define ID_BUTTON4    504
#define ID_BUTTON5    505

接着在OnInitDialog函数添加如下代码：

m_ImageList.Create(48,48,ILC_COLOR24|ILC_MASK,1,1);//图片大小必须一致
 m_hotImageList.Create(48,48,ILC_COLOR24|ILC_MASK,1,1);
 for(int i=0;i<5;i++)
 {
   m_ImageList.Add(AfxGetApp()->LoadIcon(IDI_NORMAL1+i));
   m_hotImageList.Add(AfxGetApp()->LoadIcon(IDI_HOT1+i));
 }
  UINT nArray[5];
  for(i=0;i<5;i++)
  {
   nArray[i]=ID_BUTTON1+i;
  }
  m_Toolbar.CreateEx(this);//创建工具栏控件
  m_Toolbar.SetButtons(nArray,5);
  m_Toolbar.SetSizes(CSize(60,56),CSize(48,48));
  m_Toolbar.GetToolBarCtrl().SetImageList(&m_ImageList);
  m_Toolbar.GetToolBarCtrl().SetHotImageList(&m_hotImageList);
  m_Rebar.Create(this);
  m_Rebar.AddBar(&m_Toolbar);
  m_Rebar.RedrawWindow();
  REBARBANDINFO info;
  info.cbSize=sizeof(info);
  info.fMask=RBBIM_BACKGROUND;
  m_Toolbar.ModifyStyle(0,TBSTYLE_TRANSPARENT);//设置工具栏背景色透明
  info.hbmBack=LoadBitmap(AfxGetInstanceHandle(),MAKEINTRESOURCE(IDB_TOOLBACK));
  m_Rebar.GetReBarCtrl().SetBandInfo(0,&info);
  RepositionBars(AFX_IDW_CONTROLBAR_FIRST,AFX_IDW_CONTROLBAR_LAST,0);

运行效果：

 CToolBarCtrl工具栏控制类

 这个类的用法跟CToolBar的用法大同小异，模式都差不多，只需要了解一下这个类里的Create和AddButtons函数就行了，Create函数定义如下：

BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

dwStyle：工具栏控件的风格     rect：工具栏位置和区域   pParentWnd:工具栏父窗口句柄（属于哪个窗口） nID:工具栏控件ID号

AddButtons函数用于往工具栏里添加一组按钮，函数定义如下：

BOOL AddButtons( int nNumButtons, LPTBBUTTON lpButtons );
nNumButtons:要添加的按钮数量 也就是函数第二个参数数组大小。lpButtons:一个TBBUTTON结构数组的地址

TBBUTON结构定义如下：
typedef struct _TBBUTTON
{
  int iBitmap; // 按钮显示的图片索引，没有图像为NULL，
  int idCommand; // 与此按钮相关联的命令标识符，当fsStyle具有TBSTYLE_SEP属性时，该项必须为0
  BYTE fsState; // 按钮的状态标志
  BYTE fsStyle; //按钮风格
  DWORD dwData; // 用户定义的数据

  int iString; // 按钮显示的文本内容索引，无为NULL。
} TBBUTTON;

“MFC类库详解”关于fsState和fsStyle参数的解释如下：

fsState 按钮的状态标志。它可以是下面列出的值的一个组合： · TBSTATE_CHECKED 该按钮具有TBSTYLE_CHECKED风格并且被按下。 · TBSTATE_ENABLED 按钮接收用户输入。一个不具有这个状态的按钮是不接收用户输入的，并且变灰。 · TBSTATE_HIDDEN 按钮不可见，并且不能接收用户输入。 · TBSTATE_INDETERMINATE 按钮是变灰的。 · TBSTATE_PRESSED 按钮被按下。 · TBSTATE_WRAP 按钮之后是一个分隔线。此按钮还必须具有TBSTATE_ENABLED状态。 sStyle 按钮风格。它可以是下列值的一个组合： · TBSTYLE_BUTTON 创建一个标准的按钮。 · TBSTYLE_CHECK 创建一个每次用户点击时可以在按下和弹起状态间切换的按钮。该按钮则处于按下状态时有一种不同的背景颜色。 · TBSTYLE_CHECKGROUP 创建一个核选按钮，它被选择后一直处于按下状态，直到同组中的另一个按钮被按下时它才弹起。 · TBSTYLE_GROUP 创建一个被选择后一直处于按下状态，直到同组中的另一个按钮被按下时它才弹起的按钮。 · TBSTYLE_SEP 创建一个分隔线，为按钮组之间提供一个小的间距。具有这个风格的按钮是不接收用户输入的。

用CToolBarCtrl类在窗口里显示一个工具栏的步骤如下：

引入四个图标文件到工程里，然后在对话框类定义两个变量：

 CImageList m_ImageList;
  CToolBarCtrl m_TBarCtrl;

然后在OnInitDialog函数添加如下代码：

TBBUTTON button[4];
 m_ImageList.Create(32,32,ILC_COLOR32|ILC_MASK,0,0);
 m_ImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
 m_ImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2));
 m_ImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON3));
 m_ImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON4));
    m_TBarCtrl.Create(WS_CHILD|WS_VISIBLE,CRect(0,0,0,0),this,1200);
 m_TBarCtrl.SetImageList(&m_ImageList);
 for(int i=0;i<4;i++)
 {
  button[i].fsState=TBSTATE_ENABLED;
  button[i].fsStyle=TBSTYLE_BUTTON;
  button[i].iBitmap=i;
 }
    m_TBarCtrl.AddButtons(4,button);
 m_TBarCtrl.AutoSize();
 m_TBarCtrl.SetStyle(TBSTYLE_FLAT|CCS_TOP);

运行效果：

为CToolBarCtrl类创建的工具栏添加按钮单击处理消息

 上面的TBBUTON结构里有一个成员idCommand，这个成员跟菜单项的ID值一样，用于标识工具栏按钮项，也就是说idCommand是工具栏项ID号，就是最前面设置工具栏资源时，选择一个按钮，然后按回车，弹出一个对话框，里面有一个ID项，跟这个是一样的。

所以呢，我们只要把上面的给TBBUTTON结构成员赋值的语句改成下面这样就行了：
 for(int i=0;i<4;i++)
 {
  button[i].fsState=TBSTATE_ENABLED;
  button[i].fsStyle=TBSTYLE_BUTTON;
  button[i].iBitmap=i;

button[i].idCommand=1100+i;//新加的语句
 }

这样我们只要添加ON_COMMAND消息映射就可以处理一个按钮单击消息了，如上面第一个按钮的ID号是：1100;那么手工添加这个按钮单击消息映射的语句就是：

ON_COMMAND(1100,OnToolbar1)

OnToolbar1为消息处理函数，可自行添加