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_BUTTON2ID_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_BITMAP1IDB_BITMAP2IDB_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_ICON1IDI_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_NORMAL1IDI_NORMAL2、。。。IDI_NORMAL6

热点图标ID依次为:IDI_HOT1IDI_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的用法大同小异,模式都差不多,只需要了解一下这个类里的CreateAddButtons函数就行了,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类库详解关于fsStatefsStyle参数的解释如下:

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为消息处理函数,可自行添加