CToolBarCtrl工具栏设置总结（转）

最新推荐文章于 2024-01-10 19:47:08 发布

Victor_zsg

最新推荐文章于 2024-01-10 19:47:08 发布

阅读量2k

点赞数

本文链接：https://blog.csdn.net/Victor_zsg/article/details/38921317

版权

本文详细介绍了MFC中CToolBarCtrl的使用，包括创建步骤、对象结构、控制方法和应用技巧。创建工具条分为资源创建和直接加载位图两种方式，涉及位图按钮设置、按钮状态和风格控制。CToolBarCtrl提供了丰富的属性和操作方法，如设置按钮样式、状态判断、动态提示等。此外，文章还讨论了浮动工具条、多位图工具条和对话框类工具条的建立，以及工具条的显示与隐藏控制，展示了如何通过对话框设置工具条的显示状态和属性控制。

摘要由CSDN通过智能技术生成

（一）工具条控制的主要功能

所谓工具条就是具有位图和分隔符组成的一组命令按钮，位图按钮部分可以是下推按钮、检查盒按钮、无线按钮等。工具条对象类派生于主窗口架框类CframeWnd或CMDIFrameWnd，其类控制CToolBar::GetToolBarCtrl是 MFC类库中封装的一个成员函数，允许使用类库中提供的一般控制和附加功能，CtoolBar类控制成员控制提供了Windows一般控制的所有功能，然而，通过调用 GetToolBarCtrl成员函数取得引用后，可以使工具条具有更强的特性。

工具条的创建具有四个步聚：首先是建立工具条资源；然后建立工具条对象结构；其次通过调用建立函数建立工具条对象并绑定；最后调用LoadToolBar调入工具条资源。

另外，还可以通过直接加载位图的方法来建立，步骤如下：首先建立工具条对象；然后通过调用建立函数建立工具条并绑定对象；其次调入包含按钮的位图；最后利用SetButtons 函数设置按钮的风格并与位图建立联系。

其中，所有按钮位图均存放在一个位图文件中，按钮位图的大小相同，默认为16点宽、15点高，位图必须从左至右存放。设置按钮函数具有指向一组控制标识符ID的指针和索引值，用来确定每个按钮的位置，如果存在分隔符ID_SEPARATOR, 那么该图像就不存在索引值。正常情况下工具条中的按钮都是单排从左至右排列的，可以通过SetButtonInfo函数改变排序规则。工具条中最终形成的按钮大小相同，均为24 x 22 象素，每个按钮只对象一幅图像。工具条中的按钮默认为下推按钮，通过设置TBBS_CHECKBOX风格可以实现检查盒按钮，通过调用SetRadio成员函数可以实现无线按钮。

（二）工具条控制的对象结构

1、工具条的对象结构

（1）工具条的建立方法

CToolBar ＆ToolBar 建立工具条对象结构

Create 建立工具条对象并绑定

工具条类CToolBar::Create 的调用格式如下：

BOOL Create( CWnd* pParentWnd, DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,

UINT nID = AFX_IDW_TOOLBAR );

其中参数pParentWnd用来确定指向工具条父窗口的指针；参数dwStyle用来确定工具条的风格，其取值如下；参数nID用来确定工具条子窗口的标识符。

CBRS_TOP 表示工具条在框架窗口的顶部

CBRS_BOTTOM 表示工具条在框架窗口的底部

CBRS_NOALIGN 表示工具条在父窗口改变大小时不响应

CBRS_TOOLTIPS 表示工具条具有动态提示功能

CBRS_SIZE_DYNAMIC 表示工具条是静态的不能改变

CBRS_SIZE_FIXED 表示工具条是动态的可以改变

CBRS_FLOATING 表示工具条是浮动的

CBRS_FLYBY 表示状态条上显示工具条中按钮的信息

CBRS_HIDE_INPLACE 表示工具条隐藏

除以上函数外，还包括设置按钮和位图的大小SetSizes、设置工具条的高度SetHeight、调入工具条资源LoadToolBar、调入工具条按钮位图LoadBitmap、设置工具条按钮位图SetBitmap、设置工具条中位图按钮的风格和索引值SetButtons等控制函数。

（2）工具条的类属性

工具条控制类的属性包括取得标识符ID对象按钮索引CommandToIndex、取得索引对应的命令标识符ID或分隔符GetItemID、取得索引对应的矩形区域GetItemRect、取得按钮风格 GetButtonStyle、设置按钮风格SetButtonStyle、取得按钮的ID标识－风格－图象数GetButtonInfo、设置按钮ID 标识－风格－图象数SetButtonInfo、取得按钮提示文本GetButtonText、设置按钮提示文本SetButtonText和取得工具条直接存取控制GetToolBarCtrl等。

2、工具条控制的对象结构

（1）工具条控制的建立方法

CToolBarCtrl &ToolBarCtrl 建立工具条控制对象结构

Create 建立工具条控制对象并绑定

工具条控制类CToolBarCtrl::Create的调用格式如下：

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

其中参数dwStyle用来确定工具条控制的风格，必须存在WS_CHILD风格；参数rect用来确定工具条控制的大小和位置；参数pParentWnd用来确定工具条控制的父窗口指针，不能为NULL；参数nID用来确定工具条控制的标识符。

可以利用WS_CHILD、WS_VISIBLE和WS_DISABLED来设置工具条窗口的风格，但必须合理设置如下控制风格：

CCS_ADJUSTABLE 允许用户处理工具条窗口大小，如果存在工具条窗口必须处理相应信

CCS_BOTTOM 使控制处于父窗口客户区域底部并与窗口同样宽

CCS_NODIVIDER 禁止在控制的顶部绘制2个象素的高亮条

CCS_NOHILITE 禁止在控制的顶部绘制1个象素的高亮条

CCS_NOMOVEY 使控制改变大小和移动时自动水平对齐，垂直对齐必须处理WM_SIZE消息

如果CCS_NORESIZE风格有效，则该风格无效

CCS_NOPARENTALIGN禁止控制自动移到父窗口顶部或底部，如果CCS_TOP或 CCS_BOTTOM风格

有效，则高度调整为默认而宽度可以改变

CCS_NORESIZE 禁止设置新的大小或无效值时使用默认宽度和高度值，而使用建立值

CCS_TOP 使控制自动停靠在父窗口客户区域顶部并与父窗口同样宽度

最后，还必须利用下面的风格来控制工具条

TBSTYLE_TOOLTIPS 使工具条建立并管理动态提示控制

TBSTYLE_WRAPABLE 使工具条控制按钮具有多行排列格式

(2)工具条控制中的数据结构

工具条控制中最常用的数据结构为TBBUTTON，其具体结构如下：

typedef struct _TBBUTTON {

int iBitmap; // 基于0的位图索引值

int idCommand; // 按钮按下时发送的命令值

BYTE fsState; // 按钮的状态

BYTE fsStyle; // 按钮的风格

DWORD dwData; // 应用程序定义的数据

int iString; // 基于0的按钮标签字符串索引值

} TBBUTTON;

其中按钮状态fsState的值如下：

TBSTATE_CHECKED 表示按钮具有TBSTYLE_CHECKED风格并且被按下

TBSTATE_ENABLED 表示按钮允许接受输入，否则变灰不接受任何输入

TBSTATE_HIDDEN 表示按钮不可见并且不接受任何输入

TBSTATE_INDETERMINATE 表示按钮是变灰的

TBSTATE_PRESSED 表示按钮正被按下

TBSTATE_WRAP 表示按钮具有换行特性，该按钮必须具有TBSTATE_ENABLED状态

按钮风格style可以是下列值的组合：

TBSTYLE_BUTTON 表示建立标准下推按钮

TBSTYLE_CHECK 表示建立检查状态按钮

TBSTYLE_CHECKGROUP表示建立检查按钮群

TBSTYLE_GROUP 表示建立按下状态按钮群

TBSTYLE_SEP 表示建立按钮分隔符

（３）工具条控制的类属性

工具条控制的类属性必然的联系判断按钮使能状态IsButtonEnabled、判断按钮检查状态 IsButtonChecked、判断按钮按下状态IsButtonPressed、判断按钮是否隐藏IsButtonHidden、判断按钮变灰状态 IsButtonIndeterminate、设置按钮状态SetState、取得按钮状态GetState、取得按钮有关信息GetButton、取得按钮总数GetButtonCount、取得按钮矩形区域GetItemRect、设置按钮结构大小SetButtonStructSize、设置按钮大小SetButtonSize、设置按钮位图大小SetBitmapSize、取得按钮提示控制GetToolTips、设置按钮提示控制 SetToolTips等。

（4）工具条控制类的操作方法

工具条控制类的操作方法包括使能按钮EnableButton、检查按钮CheckButton、按下按钮PressButton、隐藏按钮HideButton、变灰按钮Indeterminate、增加按钮AddButtons、插入按钮 InsertButton、删除按钮DeleteButton、取得控制符ID对应的索引CommandToIndex、恢复工具条状态 RestoreState、保存工具条状态SaveState和重新确定工具条大小AutoSize等。

（三）工具条控制的应用技巧

可以这样说，工具条和上述常用控制是应用程序中不可缺少的功能元素，它的优劣会直接影响程序的基本功能和操作特性。所以这里将对工具条的建立技巧、状态保存与恢复、平面特性、停靠位置、排序方法、消息映射、状态更新、控制使用和属性控制等方面，全面阐述工具条的使用技巧。

1、工具条的建立技巧

（1）普通工具条的建立方法

如果应用程序在建立时就具有工具条，则只需对工具条中的按钮图标进行简单的增加、修改和删除等操作就可满足要求。如果未建立或者想增加其它工具条，则应按步骤追加建立。

首先打开已建立好的基于单文档的框架工程文件CTool并选择"Insert->Resource->ToolBar"选项，插入工具条资源并设置资源标识符；然后编辑工具栏中的按钮图标和相应的按钮标识符，并利用类向导ClassWizard 为按钮消息增加COMMAND和UPDATE_COMMAND_UI两种处理函数；在资源文件中增加和修改工具条图标的动态提示等内容；打开MainFrm.h包含文件在"CToolBar m_wndMainToolBar"后增加"CToolBar m_wndTestToolBar" 等来创建增加的工具条对象；在MainFrm.h 中设置建立函数所需的成员变量，如颜色变量为m_bColor、动态提示功能变量为m_bToolTips 等，注意成员变量名与其获取的参数应完全对应以便使用；最后在MainFrm.cpp中的OnCreate()建立函数中按下述示例规则增加控制代码，其实现具体步骤如下：

①在MainFrm.h中增加工具条对象控制和成员变量

#define TOOLLEFT 18

class CMainFrame:public CFrameWnd

......//其它代码

public:

BOOL m_bToolTips;//工具条提示功能

......//其它代码

protected://工具条控制成员变量

CStatusBar m_wndStatusBar; //框架程序的状态条

CTestToolBar m_wndMainToolBar;//框架程序的工具条

CTestToolBar m_wndTestToolBar;//新增工具条

CTestToolBar m_wndDockToolBar;//浮动工具条

CTestToolBar m_wndDockNextBar;//浮动工具条

......//其它代码

}

框架程序中工具条的控制类正常应为CToolBar，可以是自己设计的派生类CtestToolBar（为笔者扩充平面特性等功能后的新工具条控制类名）等，具体根据实际需要而定。利用CDialogBar类和CStyleBar 类还可以建立扩展类型的工具条，详见后面工具条中控制应用技巧，但在该文件头处必须

包含如下命令：

#ifndef __AFXEXT_H__

#include <afxext.h>//直接存取CToolBar和CStatusBar

#endif

②在MainFrm.cpp中完善窗口建立函数

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)

{ if (CFrameWnd::OnCreate(lpCreateStruct) == -1)

return -1;

WINDOWPLACEMENT wp;//保存主窗口及工具栏窗口位置状态

if (ReadWindowPlacement(&wp))//读取位置状态信息

SetWindowPlacement(&wp); //设置位置状态信息

m_bToolTips=(AfxGetApp()->GetProfileInt(//读提示功能

_T("General"),_T("ToolTips"),1)!=0); //默认值为1

m_wndMainToolBar.SetState(TOOLLEFT,TRUE);//设置初始状态

EnableDocking(CBRS_ALIGN_ANY);//停靠位置，必须提前位置

if (!m_wndMainToolBar.Create(this,WS_CHILD|WS_VISIBLE

|CBRS_SIZE_DYNAMIC|CBRS_TOP|((m_bToolTips)?

(CBRS_TOOLTIPS|CBRS_FLYBY):0),IDR_MAINFRAME)||

!m_wndMainToolBar.LoadToolBar(IDR_MAINFRAME))

{ //CBRS_SIZE_DYNAMIC为锁定位置风格

TRACE0("主工具条MAINFRAME建立失败/n");

return -1;} // 建立失败处理

......//建立其它工具条代码，基本相同

if (!m_wndStatusBar.Create(this)||

!m_wndStatusBar.SetIndicators(indicators,

sizeof(indicators)/sizeof(UINT)))

{ //建立状态条

TRACE0("Failed to create status bar/n");

return -1;} // fail to create

m_wndMainToolBar.SetWindowText(_T("主工具栏"));//设置标题

m_wndMainToolBar.EnableDocking(CBRS_ALIGN_ANY);//停靠位置

//m_wndMainToolBar.ModifyStyle(0,TBSTYLE_FLAT);//平面特性

......//设置其它工具条位置代码，基本相同

DockControlBar(&m_wndMainToolBar,

AFX_IDW_DOCKBAR_TOP);//锁定位置

DockControlBarLeftOf(&m_wndTestToolBar,

&m_wndMainToolBar);//连接工具条

DockControlBar(&m_wndDockToolBar,AFX_IDW_DOCKBAR_RIGHT);

m_wndDockToolBar.SetColumns(AfxGetApp()->GetProfileInt(

_T("General"),_T("Columns"),3));//恢复列格式,默认为3

DockControlBarLeftOf(&m_wndDockNextBar,&m_wndDockToolBar);

m_wndDockNextBar.SetColumns(AfxGetApp()->GetProfileInt(

_T("General"),_T("Columns"),3));

LoadBarState(_T("General"));//恢复保存的状态和位置

return 0;

}

以上建立过程除工具条建立和资源调用函数外，还涉及到了窗口和工具条的状态保存和恢复函数、注册表参数读取函数、工具条停靠位置函数、工具条标题修改函数、工具条连接函数、工具条列格式控制函数和工具条风格修改函数，其中工具条建立函数中的风格设置很重要，如果建立的工具条需要重新设置多行多列的排序功能，除正确设置工具条停靠位置参数外，还必须设置CBRS_SIZE_FIXED 风格，即允许程序改变工具条窗口的尺寸，如果工具条不需要重新排序，则必须设置为CBRS_SIZE_DYNAMIC 风格，否则工具栏不但不能进行重新排序和正确停靠到理想的位置，而且也无法正确保存和恢复工具条的位置和状态，这一点应引起编程者高度重视。其余函数以后分别介绍。

(2)浮动工具条的建立方法

如果要建立浮动工具条，必须使用如下工具条的控制方法：

Cpoint pt(GetSystemMetrics(SM_CXSCREEN)-100,GetSystemMetrics(SM_CYSCREEN)/3);

FloatControlBar(&m_wndPaletteBar,pt);//浮动工具条

（3）多位图工具条的建立方法

如果工具条存在多幅按钮位图，如单色和彩色等，则必须将工具条按钮存在在位图资源文件中而不是工具条资源中，并如下建立：

if(!m_wndDockToolBar.Create(this,WS_CHILD|WS_VISIBLE|

CBRS_SIZE_FIXED|CBRS_TOP|CBRS_TOOLTIPS,ID_PALETTEBAR)||

!m_wndDockToolBar.LoadBitmap(IDR_DOCKTOOLBAR)||

!m_wndDockToolBar.SetButtons(DockTool,

sizeof(DockTool)/sizeof(UINT)))

其中DockTool为按钮IDs数据结构，其定义方法如下：