CToolBar的使用总结.doc
《CToolBar的使用总结.doc》由会员分享,可在线阅读,更多相关《CToolBar的使用总结.doc(60页珍藏版)》请在三一文库上搜索。
1、(一)工具条控制的主要功能所谓工具条就是具有位图和分隔符组成的一组命令按钮,位图按钮部分可以是下推按钮、检查盒按钮、无线按 钮等。工具条对象类派生于主窗口架框类CframeWnd或CMDIFrameWnd,其类控制CToolBar:GetToolBarCtrl是 MFC类库中封装的一个成员函数,允许使用类库中提供的一般控制和附加功能,CtoolBar类控制成员控制提供了Windows一般控制的所有功能,然 而,通过调用 GetToolBarCtrl成员函数取得引用后,可以使工具条具有更强的特性。工具条的创建具有四个步聚:首先是建立工具条资源;然后建立工具条对象结构;其次通过调用建立函数建立工具
2、条对象并绑定;最后调用LoadToolBar调入工具条资源。另外,还可以通过直接加载位图的方法来建立,步骤如下:首先建立工具条对象;然后通过调用建立函数建立工具条并绑定对象;其次调入包含按钮的位图;最后利用SetButtons 函数设置按钮的风格并与位图建立联系。其中,所有按钮位图均存放在一个位图文件中,按钮位图的大小相同,默认为16点宽、15点高,位图必须从左至右存放。设置按钮函数具有指向一组控制标识符ID的指针和索引值,用来确定每个按钮的位置,如果存在分隔符ID_SEPARATOR, 那么该图像就不存在索引值。正常情况下工具条中的按钮都是单排从左至右排列的,可以通过SetButtonInf
3、o函数改变排序规则。 工具条中最终形成的按钮大小相同,均为24 x 22 象素,每个按钮只对象一幅图像。工具条中的按钮默认为下推按钮,通过设置TBBS_CHECKBOX风格可以实现检查盒按钮,通过调用SetRadio成员函数可以实现无线按钮。(二)工具条控制的对象结构1、工具条的对象结构(1)工具条的建立方法CToolBar ToolBar 建立工具条对象结构Create 建立工具条对象并绑定工具条类CToolBar:Create 的调用格式如下:BOOL Create( CWnd* pParentWnd, DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBR
4、S_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 表示工具条是浮动的C
5、BRS_FLYBY 表示状态条上显示工具条中按钮的信息 CBRS_HIDE_INPLACE 表示工具条隐藏除以上函数外,还包括设置按钮和位图的大小SetSizes、设置工具条的高度SetHeight、调 入工具条资源LoadToolBar、调入工具条按钮位图LoadBitmap、设置工具条按钮位图SetBitmap、设置工具条中位图按钮的风格和索 引值SetButtons等控制函数。(2)工具条的类属性工具条控制类的属性包括取得标识符ID对象按钮索引CommandToIndex、取得索引对应的命令 标识符ID或分隔符GetItemID、取得索引对应的矩形区域GetItemRect、取得按钮风格
6、 GetButtonStyle、设置按钮风格SetButtonStyle、取得按钮的ID标识风格图象数GetButtonInfo、设置按钮ID 标识风格图象数SetButtonInfo、取得按钮提示文本GetButtonText、设置按钮提示文本SetButtonText和取得工具条 直接存取控制GetToolBarCtrl等。2、工具条控制的对象结构(1)工具条控制的建立方法CToolBarCtrl &ToolBarCtrl 建立工具条控制对象结构Create 建立工具条控制对象并绑定工具条控制类CToolBarCtrl:Create的调用格式如下:BOOL Create( DWORD dw
7、Style, const RECT& rect, CWnd* pParentWnd, UINT nID );其中参数dwStyle用来确定工具条控制的风格,必须存在WS_CHILD风格;参数rect用来确定工具条控制的大小和位置;参数pParentWnd用来确定工具条控制的父窗口指针,不能为NULL;参数nID用来确定工具条控制的标识符。可以利用WS_CHILD、WS_VISIBLE和WS_DISABLED来设置工具条窗口的风格,但必须合理设置如下控制风格:CCS_ADJUSTABLE 允许用户处理工具条窗口大小,如果存在工具条窗口必须处理相应信CCS_BOTTOM 使控制处于父窗口客户区域底
8、部并与窗口同样宽CCS_NODIVIDER 禁止在控制的顶部绘制2个象素的高亮条CCS_NOHILITE 禁止在控制的顶部绘制1个象素的高亮条CCS_NOMOVEY 使控制改变大小和移动时自动水平对齐,垂直对齐必须处理WM_SIZE消息如果CCS_NORESIZE风格有效,则该风格无效CCS_NOPARENTALIGN禁止控制自动移到父窗口顶部或底部,如果CCS_TOP或 CCS_BOTTOM风格有效,则高度调整为默认而宽度可以改变CCS_NORESIZE 禁止设置新的大小或无效值时使用默认宽度和高度值,而使用建立值CCS_TOP 使控制自动停靠在父窗口客户区域顶部并与父窗口同样宽度最后,还必
9、须利用下面的风格来控制工具条TBSTYLE_TOOLTIPS 使工具条建立并管理动态提示控制TBSTYLE_WRAPABLE 使工具条控制按钮具有多行排列格式(2)工具条控制中的数据结构工具条控制中最常用的数据结构为TBBUTTON,其具体结构如下:typedef struct _TBBUTTON int iBitmap; / 基于0的位图索引值int idCommand; / 按钮按下时发送的命令值BYTE fsState; / 按钮的状态BYTE fsStyle; / 按钮的风格DWORD dwData; / 应用程序定义的数据int iString; / 基于0的按钮标签字符串索引值 T
10、BBUTTON;其中按钮状态fsState的值如下:TBSTATE_CHECKED 表示按钮具有TBSTYLE_CHECKED风格并且被按下TBSTATE_ENABLED 表示按钮允许接受输入,否则变灰不接受任何输入TBSTATE_HIDDEN 表示按钮不可见并且不接受任何输入TBSTATE_INDETERMINATE 表示按钮是变灰的TBSTATE_PRESSED 表示按钮正被按下TBSTATE_WRAP 表示按钮具有换行特性,该按钮必须具有TBSTATE_ENABLED状态按钮风格style可以是下列值的组合:TBSTYLE_BUTTON 表示建立标准下推按钮TBSTYLE_CHECK 表
11、示建立检查状态按钮TBSTYLE_CHECKGROUP表示建立检查按钮群TBSTYLE_GROUP 表示建立按下状态按钮群TBSTYLE_SEP 表示建立按钮分隔符()工具条控制的类属性工具条控制的类属性必然的联系判断按钮使能状态IsButtonEnabled、判断按钮检查状态 IsButtonChecked、判断按钮按下状态IsButtonPressed、判断按钮是否隐藏IsButtonHidden、判断按钮变灰状态 IsButtonIndeterminate、设置按钮状态SetState、取得按钮状态GetState、取得按钮有关信息GetButton、取得 按钮总数GetButtonCo
12、unt、取得按钮矩形区域GetItemRect、设置按钮结构大小SetButtonStructSize、设置按钮大 小SetButtonSize、设置按钮位图大小SetBitmapSize、取得按钮提示控制GetToolTips、设置按钮提示控制 SetToolTips等。(4)工具条控制类的操作方法工具条控制类的操作方法包括使能按钮EnableButton、检查按钮CheckButton、按下 按钮PressButton、隐藏按钮HideButton、变灰按钮Indeterminate、增加按钮AddButtons、插入按钮 InsertButton、删除按钮DeleteButton、取得控
13、制符ID对应的索引CommandToIndex、恢复工具条状态 RestoreState、保存工具条状态SaveState和重新确定工具条大小AutoSize等。(三)工具条控制的应用技巧可以这样说,工具条和上述常用控制是应用程序中不可缺少的功能元素,它的优劣会直接影响程序的基本功能和操作特性。所以这里将对工具条的建立技巧、状态保存与恢复、平面特性、停靠位置、排序方法、消息映射、状态更新、控制使用和属性控制等方面,全面阐述工具条的使用技巧。1、工具条的建立技巧(1)普通工具条的建立方法如果应用程序在建立时就具有工具条,则只需对工具条中的按钮图标进行简单的增加、修改和删除等操作就可满足要求。如果
14、未建立或者想增加其它工具条,则应按步骤追加建立。首先打开已建立好的基于单文档的框架工程文件CTool并选择Insert-Resource-ToolBar选项,插入工具条资源并设置资源标识符;然后编辑工具栏中的按钮图标和相应的按钮标识符,并利用类向导ClassWizard 为按钮消息增加COMMAND和UPDATE_COMMAND_UI两种处理函数;在资源文件中增加和修改工具条图标的动态提示等内容;打开MainFrm.h包含文件在CToolBar m_wndMainToolBar后增加CToolBar m_wndTestToolBar 等来创建增加的工具条对象;在MainFrm.h 中设置建立函
15、数所需的成员变量,如颜色变量为m_bColor、动态提示功能变量为m_bToolTips 等,注意成员变量名与其获取的参数应完全对应以便使用;最后在MainFrm.cpp中的OnCreate()建立函数中按下述示例规则增加控制代码,其实现具体步骤如下:在MainFrm.h中增加工具条对象控制和成员变量#define TOOLLEFT 18class CMainFrame:public CFrameWnd./其它代码public:BOOL m_bToolTips;/工具条提示功能./其它代码protected:/工具条控制成员变量CStatusBar m_wndStatusBar; /框架程序的
16、状态条CTestToolBar m_wndMainToolBar;/框架程序的工具条CTestToolBar m_wndTestToolBar;/新增工具条CTestToolBar m_wndDockToolBar;/浮动工具条CTestToolBar m_wndDockNextBar;/浮动工具条./其它代码框架程序中工具条的控制类正常应为CToolBar,可以是自己设计的派生类CtestToolBar(为笔者扩充平面特性等功能后的新工具条控制类名)等,具体根据实际需要而定。利用CDialogBar类和CStyleBar 类还可以建立扩展类型的工具条,详见后面工具条中控制应用技巧,但在该文件
17、头处必须包含如下命令:#ifndef _AFXEXT_H_#include /直接存取CToolBar和CStatusBar#endif在MainFrm.cpp中完善窗口建立函数int CMainFrame:OnCreate(LPCREATESTRUCT lpCreateStruct) if (CFrameWnd:OnCreate(lpCreateStruct) = -1)return -1;WINDOWPLACEMENT wp;/保存主窗口及工具栏窗口位置状态if (ReadWindowPlacement(&wp)/读取位置状态信息SetWindowPlacement(&wp); /设置位置
18、状态信息m_bToolTips=(AfxGetApp()-GetProfileInt(/读提示功能_T(General),_T(ToolTips),1)!=0); /默认值为1m_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):
19、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 barn);r
20、eturn -1; / fail to createm_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_wndMain
21、ToolBar);/连接工具条DockControlBar(&m_wndDockToolBar,AFX_IDW_DOCKBAR_RIGHT);m_wndDockToolBar.SetColumns(AfxGetApp()-GetProfileInt(_T(General),_T(Columns),3);/恢复列格式,默认为3DockControlBarLeftOf(&m_wndDockNextBar,&m_wndDockToolBar);m_wndDockNextBar.SetColumns(AfxGetApp()-GetProfileInt(_T(General),_T(Columns),3
22、);LoadBarState(_T(General);/恢复保存的状态和位置return 0;以上建立过程除工具条建立和资源调用函数外,还涉及到了窗口和工具条的状态保存和恢复函数、注册表参数 读取函数、工具条停靠位置函数、工具条标题修改函数、工具条连接函数、工具条列格式控制函数和工具条风格修改函数,其中工具条建立函数中的风格设置很重 要,如果建立的工具条需要重新设置多行多列的排序功能,除正确设置工具条停靠位置参数外,还必须设置CBRS_SIZE_FIXED 风格,即允许程序改变工具条窗口的尺寸,如果工具条不需要重新排序,则必须设置为CBRS_SIZE_DYNAMIC 风格,否则工具栏不但不能进
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- CToolBar 使用 总结
链接地址:https://www.31doc.com/p-2508765.html