CToolBar的使用总结(2)

来源:互联网 发布:mac mpv 安装教程 编辑:程序博客网 时间:2024/06/06 09:47
米度软件:www.midosoft.cn

 

 

  4、工具条的停靠位置

  (1)标准工具条的停靠位置

  工具条类CToolBar是控制条类CControlBar 的派生类,其显示的初始停靠位置是通过调用继承的函数CControlBar::EnableDocking(DWORD dwStyle)来确定的,其参数dwStyle用来指定停靠具体位置,与本文有关的风格如下,其余请参阅VC5的联机帮助:

  CBRS_ALIGN_TOP 工具条停靠在客户区域顶部

  CBRS_ALIGN_BOTTOM 工具条停靠在客户区域底部

  CBRS_ALIGN_LEFT 工具条停靠在客户区域左边

  CBRS_ALIGN_RIGHT 工具条停靠在客户区域右边

  CBRS_ALIGN_ANY 工具条停靠在客户区域任何位置

  利用应用程序向导AppWizard 生成的应用程序,其默认的停靠位置为CBRS_ALIGN_ANY,即允许停靠在客户区域的任何边,正常显示时为靠近客户区域的顶部:EnableDocking(CBRS_ALIGN_ANY) ,详见上述的工具栏建立函数ONCREATE()。

  应用程序的单文档和多文档的窗口框架类均为CFrameWnd 的派生类,其指定工具条的停靠位置均是通过调用继承的函数 CFrameWnd::EnableDocking(DWORD dwDockStyle)来实现的,其可选的参数除上述五种之外,还增加了CBRS_FLOAT_MULTI参数,这个参数主要是为设计浮动工具条而增加 的,其用来确定一个框架窗口中允许存在多个浮动工具栏。同样利用应用程序向导AppWizard 生成的应用程序,其默认的停靠位置也是CBRS_ALIGN_ANY,即允许停靠在框架窗口的任何边,正常显示时为靠近框架窗口  的顶部,即为 EnableDocking(CBRS_ALIGN_ANY),详见上述的工具条建立函数ONCREATE()。

 

  (2)浮动工具条的停靠位置

  当一个框架窗口中存在多个浮动工具条时,需要利用函数void DockControlBar(CControlBar *pBar,UINT nDockBarID=0,LPCRECT lpRect= NULL)来确定要控制停靠位置的工具条,它也是CFrameWnd类的成员函数,其中参数pBar用来指向被控制停靠位置的工具条对象,参数 nDockBarID用来确定工具条停靠在框架窗口的哪条边上,取值为:

  AFX_IDW_DOCKBAR_TOP 工具条停靠在框架窗口的顶部

  AFX_IDW_DOCKBAR_BOTTOM 工具条停靠在框架窗口的底部

  AFX_IDW_DOCKBAR_LEFT 工具条停靠在框架窗口的左边

  AFX_IDW_DOCKBAR_RIGHT 工具条停靠在框架窗口的右边

  如果参数nDockBarID取值为0,则工具条可以停靠在框架窗口中的任何一个可停靠的边上,其默认位置为顶部。

 

  (3)工具条的连接停靠方法

  在很多应用程序中都存在将多个工具条同时停靠在某窗口的某一条边上的同一工具条窗口中的情况,利用上述工具条控制函数DockControlBar的lpRect参数,通过控制工具条的停靠矩形区域来实现这个功能,如笔者实现的函数如下:

 

  ①在主程序实现文件MainFrm.h中增加函数定义

  public:

    void DockControlBarLeftOf(CToolBar* Bar,CToolBar* LeftOf);

 

  ②在主程序实现文件MainFrm.cpp中增加如下函数

  

  在这个函数中应注意对RecalcLayout()函数和OffsetRect()函数的调用,前一个函数用来重新显示被调整的客户区和工具条,后一个函数用来重新确定矩形区域,这相当于用鼠标将第二个工具条拖动到前一个工具条上。

 

  ③修改应用程序建立函数OnCreate()函数中的相应DockControlBar()函数为DoctControlBarOf()函数,并正确设置工具条指针,见工具条的建立技巧中的有关函数。

 

  (4)定制工具条的顶部停靠控制

  另一种工具条的停靠位置是定制工具条的停靠位置,如具有通用控制功能工具条的停靠位置,这主要实现左侧定制工具条与顶部工具条之间的位置关系。其实现方法如下:

 

  ①打开菜单资源增加顶部位置控制菜单项IDD_DLGBARTOP;

 

  ②在实现文件MainFrm.h中增加成员控制变量m_bDialogTop;

  BOOL m_bDialogTop;

  并在构造函数中为其设置初始值;

 

  ③利用类向导函数为菜单项设置响应函数;

 

  ④在实现文件MainFrm.cpp中完善消息映射函数。

  

 

  5、工具条按钮的排序方法

  利用应用程序向导AppWizard 生成的应用程序工具条,其按钮均为单行水平排列的,这在实际程序开发时既不美观又不实用,很多大型应用程序等界面中的工具条都采用多行多列的排序方式,要在自己的应用程序中实现这种排列方式,应按下述方法在派生类中控制:

 

  (1)在TestToolBar.h中增加函数定义和成员变量控制

    

 

  (2)在TestToolBar.cpp中增加变量初始化和函数

  

 

  (3)在应用程序建立函数OnCreate()中为相应的工具条增加列控制功能,并注意对保存和恢复工具条状态函数的列控制参数处理,请参阅工具条建立技巧和状态保存与恢复中的有关函数,重新编译并执行应用程序就可以看到多行多列的工具条。

 

  6、工具条的消息映射技巧

  如果工具条上的按钮都存在对应的菜单命令,那么可以直接利用类向导ClassWizard 进行命令消息的映射,否则必须通过手工的方法来进行命令按钮的消息映射。由于同一工具栏的命令按钮都存在相类似的功能,所以只要注意将同一工具条中的命令 按钮ID值设置成连续值,就可以利用范围命令处理机制统一对所有按钮命令进行管理,即所有命令按钮的消息可以在同一命令消息处理函数和更新命令消息处理函 数中进行管理,这样不但结构紧凑而且维护特别方便。鉴于类向导ClassWizard 不支持范围命令处理功能,所以其消息映射机制必须通过手工方式来完成。按钮命令消息既可以在框架窗口中映射,也可以在文档和视图中完成映射,由于文档对象 通常用来管理程序中的数据部分,并且在多文档应用程序(MDI) 中,一个文档可能有多个视图与之关联,因此把工具栏中的命令按钮消息映射在文档中比较合适些。其实现步骤如下:

 

  (1)在文档实现文件CToolDoc.h中增加函数定义和数据成员:

    

 

  (2)在文档实现文件CToolDoc.cpp中进行消息映射

  

  由于命令按钮比较多,其处理功能代码部分这里省略。

 

  7、驾驭工具条按钮的状态显示更新

 

  (1)互斥按钮的状态更新

  很多应用程序中都存在相互排斥的工具条按钮,如开始和停止按钮,初始状态时停止按钮被禁止,当应用程序进行数据通讯、查找和打印等功能时,停止按钮有效而开始按钮禁止,当命令结束或按停止按钮后,开始按钮有效而停止按钮被禁止。这就是工具条中按钮的显示状态更新问题。

  与菜单栏一样,工具条的构造、析构过程及其窗口的创建都是由应用程序的主框架窗口来管理的。当用户点击 菜单条的菜单项时,Windows 就会向应用程序发送WM_INITMENUPOPUP消息,以便应用程序在菜单显示之前对菜单项进行添加或修改,当利用MFC 类库编程时只要针对某一具体的菜单项进行消息映射,加入相应的消息处理函数,MFC类库就会发送更新消息UPDATE_COMMAND_UI,使菜单在弹 出时消息处理函数能够对菜单项进行禁止、变灰和其它处理。工具条的消息处理过程与菜单栏完全相同,它也存在工具条显示更新消息 UPDATE_COMMAND_UI ,只不是由于工具条总是处于显示状态,所以对其消息处理函数的调用是在应用程序的空闲状态时进行处理的,这点与菜单栏有所不同,当应用程序命令按钮所要执 行的功能占用大量的处理器资源时,如进行通讯处理或大量数据计算时,应用程序的主框架窗口就无暇进入空闲状态,于是工具条中的命令按钮函数就不能被及时调 用,按钮的显示状态就不能被及时更新,这就为工具条按钮的显示状态及时更新带来一定的困难。

  基于文档的应用程序一般情况下都是在文档视中对工具条按钮进行处理,所以要实现按钮显示状态的及时更新,必须在命令按钮响应函数中利用CToolBarCtrl类的成员函数EnableButton()函数对按钮的显示状态进行必要的处理,其步骤如下:

 

  ①首先利用类向导ClassWizard 对CCTOOLView类进行开始按钮和停止按钮的COMMAND命令消息映射,增加对应消息的处理函数;

 

  ②在实现文件CTOOLView.h中增加成员变量:

  public:

    BOOL m_bContiune;//开始按钮标志

    BOOL m_bSet;//结束按钮标志

 

  ③在实现文件CTOOLView.cpp中增加代码完善按钮状态更新:

  

  在开始按钮函数中,当在屏幕上不断显示信息的同时必须利用消息处理函数检查消息队列,并解释和分配相应 的消息,否则其它按钮就无法检查到应用程序的鼠标等消息,无法实现显示状态更新;在更新按钮显示状态前,必须先取得工具栏对象和相应的控制指针,然后才能 实现对按钮状态的控制,并且要实现按钮状态的更新,其设置按钮的更新功能函数必须最后执行结束才能有效,即在停止按钮函数中必须判断标志并检测消息队列。

 

  ④在平面工具条派生类中的鼠标按下函数中增加代码,以实现鼠标按下开始和停止按钮后,保证按钮的正常按下和显示状态:

    

 

  (2)按钮按下状态的切换更新

另一种按钮状态的更新情况是按钮按下状态的切换更新,这在绘图工具条和屏幕字体效果工具条中最常见。其实现步骤如下:

 

  ①首先在MainFrm.cpp中手工增加消息范围映射函数

  ON_COMMAND_RANGE(ID_EDIT_TOGGLE,ID_EDIT_UNINDENT,OnButton)

  ON_UPDATE_COMMAND_UI_RANGE(ID_EDIT_TOGGLE,

  ID_EDIT_UNINDENT,OnUpdateButton)

 

  ②然后在MainFrm.h中消息映射的最后增加成员函数定义和记录按下按钮序号的成员控制变量

  int m_bIndex;//按下按钮序号

  afx_msg void OnButton(UINT nID);

  afx_msg void OnUpdateButton(CCmdUI* pCmdUI);

 

  ③最后分别增加实现消息函数的功能代码

  

  如果涉及到其它控制的变化,可在这两个函数中分别增加。

 

  (3)按钮的部分显示更新

  最后一种更新工具条按钮显示状态的情况是部分按钮显示,这需要利用SetButtons()和SetButtonInfo()函数有效处理。步骤如下:

 

  ①首先在菜单栏中增加控制菜单项;

 

  ②在应用程序实现文件CTool.h中增加如下消息定义和函数定义

  

 

  ③在应用程序实现文件CTool. cpp中增加如下代码和副本函数功能,这个函数在工具条按钮的各种显示状态更新中都非常有用,是一个非常重要的程序设计技巧。

  在初始化函数CCTOOLApp::InitInstance()最后增加代码:

  m_pMainWnd = pMainFrame;

  完善相应的功能函数:

    

 

  ④最后在菜单项处理函数中进行工具条按钮的重组处理,并在需要处理应用程序窗口副本的任何函数中增加副本处理函数。

    

 

  8、工具条中的通用控制使用

  在工具条中通常不都是按钮,如存在输入框、下拉组合框和检查盒按钮等。这就需要利用VC中提供的特殊类型的工具条类控制或通过派生新类的方法来实现。

 

  (1)在派生的新类中实现控制

  如果利用派生新类的方法,很容易就可以实现文本输入框等通用控制功能。其实现步骤如下:

  ①利用类向导ClassWizard 建立新类CEDITBAR并生成实现文件;

  ②利用资源编辑器建立工具条的位图文件;

  ③在新类实现文件EDITBAR.h中增加如下函数定义和成员变量:

  

 

  ④在新类实现文件EDITBAR.cpp中增加如下函数:

    

 

  ⑤利用类向导ClassWizard建立新类CSearchBox并生成实现文件,同时为新类增加解释消息,即在新类实现文件SearchBox.h中增加如下函数定义:

  virtual BOOL PreTranslateMessage(MSG* pMsg);

 

  ⑥在其实现文件SearchBox.cpp文件中完善相应函数

  

 

  ⑦在主程序实现文件MainFrm.h中增加工具条定义

  #include "EDITBAR.H"

  CEDITBAR m_wndEditBar;//带输入框工具条

 

  ⑧在主程序实现文件MainFrm.cpp中增加代码:

  //在建立函数OnCreate中增加

  

  此外,还可以为工具条增加按钮检查状态等控制功能,详见工具条按钮的显示状态更新。

 

  (2)利用工具条风格类实现控制

  利用工具条风格类同样可以实现下拉列表等控制功能,其具体步骤如下:

 

  ①为工具栏建立位图按钮并定义按钮对应的消息,同前;

 

  ②在实现文件MainFrm.h中增加工具栏控制和函数定义;

  CStyleBar m_wndStyleBar;

  BOOL CreateStyleBar()

 

  ③在实现文件MainFrm.cpp中增加控制代码

  在建立函数OnCreate中增加建立函数

  if (!CreateStyleBar()) return -1;

  增加建立相应工具条函数的代码

  

  同样,也可以为这个特殊风格的工具条增加其它控制功能。

 

  (3)利用对话框类建立多功能工具条

  利用对话框工具条类可以建立功能更加强大的工具条,在对话框中实现的功能都可以增加到工具条中去。工具步骤如下:

 

  ①利用对话框资源增加一个对话框IDD_DLGTOOLBAR,并设计好对话框中的所有功能及功能对应的ID标识;

 

  ②在实现文件MainFrm.h中增加对话框工具条类控制和成员变量

  CDialogBar m_wndDlgBar; //对话框工具条控制

  BOOL m_bDialogTop;//顶部标志

 

  ③在实现文件MainFrm.cpp中增加控制代码

  在建立函数OnCreate函数的状态条建立函数后增加:

  

  一定要注意EnableDocking(CBRS_ALIGN_ANY)函数在所有建立函数的前面,并且对话框工具条在状态条建立函数的后面。

 

  ④为对话框资源中的所有控制消息手工增加映射,并完善相应的映射函数,可以是工具条的显示与隐藏等功能。示例函数如下:

    

 

  ⑤在菜单中增加顶部控制菜单项,建立消息函数后按照工具条的停靠位置中的方法为其完善相应的顶部控制功能函数。

 

  9、工具条的显示和隐藏

  (1)单一工具条的显示与隐藏

  在大型应用程序中可能存在很多工具条,而用户实际使用时可能只需要其中的一部分,这就需要控制工具条的显示隐藏。对于单个工具条,其菜单项的一般控制方法为:

  首先打开菜单编辑器,在查看菜单栏中增加工具条对应的子菜单项,如为TestToolBar 工具条增加的子菜单项的“测试”的ID为ID_BOTTON_TEST,其Caption 为“测试工具条”,依次增加其它工具条的控制子菜单项。利用类向导ClassWizard 为主框架窗口类CMainFrame增加各子菜单项的ONCOMMAND和ON_UPDATE_COMMAND_UI 消息映射功能函数,并完善对应的功能函数:

    

 

  (2)特殊工具条的显示与隐藏

  当存在利用CStyleBar 类等建立的具有特殊控制功能的工具条时,工具条的显示与消隐必须利用下面的函数:

  

 

  (3)多工具条的显示与隐藏

  如果存在很多工具条,使用菜单控制的方法并不方便,最好采用对话框设置的方法,如笔者在程序中通过对话框来控制工具条的显示与消隐、按钮排列数和动态提示功能的取舍。其步骤如下:

 

  ①首先打开资源列表中的对话框资源,利用"Insert->Resource-> Dialog"插入对话框IDD_TOOLBAR,在对话框中建立四个工具条复选框按钮、四个排列数值的单选按钮和两个动态提示功能的单选按钮(请有关图 形),并为各按钮设置ID标识和按钮名称,注意选中每组按钮中首按钮的Group属性;

 

  ②通过双击增加的对话框标题栏为对话框建立新类CToolDlg和两个实现文件ToolDlg.h和ToolDlg.cpp;

 

  ③打开对话框实现文件ToolDlg.h,增加如下成员控制变量:

  

 

  ④在实现文件ToolDlg.cpp中增加如下控制代码:

  

 

  ⑤在主程序实现文件MainFrm.cpp 中增加ToolDlg.h 包含文件,并完善相应菜单选项功能。如笔者程序中为完善“测试”选项的功能,其控制代码如下:

    

 

  10、工具条的属性控制

  WIN95/98中的鼠标右键弹出属性表功能具有很强的功能特色,很多应用程序中都对各种功能进行了属 性控制设置,给应用程序中的工具条增加属性控制功能更具有现实意义。在工具条的属性表中可以设置工具栏的消隐与显示、工具条按钮的排序和其它各种控制功 能,这要根据应用程序的需要来确定。这里以控制工具条的显示与消隐为例,详细阐述其实现的具体步骤:

 

  (1)首先打开资源列表中的菜单资源,利用"Insert->Resource-> Menu"增加菜单资源IDR_TOOLBAR,在菜单中建立四个工具条菜单选项,并为各菜单选项设置ID标识和菜单项名,注意将各菜单选项标识符设置为 与工具条名称完全相同的控制符,如本例程序中主控工具条ID为IDR_wndMainToolBar,那么控制主控工具条的菜单选项ID标识符也必须是 IDR_wndMainToolBar,这样设置后可以使用MFC 类库中的提供的功能来控制工具条的显示与消隐、菜单项检查状态与非检查状态。

 

  (2)然后利用类向导ClassWizard 为应用程序主框架窗口增加解释消息PreTranslateMessage处理函数;

 

  (3)在应用程序实现文件MainFrm.cpp中完善解释消息函数:

  

 

  (4)在消息映射函数后增加

    

 

  (5)重要的程序设计技巧步骤

  上述步骤1和步骤4是实现工具条属性菜单有效控制的最关键步骤,如果不在步骤1中将菜单ID设置成工具 条的ID,或者不在步骤4中设置相应的消息映射,都不可能实现工具条菜单与工具条状态的有效控制。工具条菜单中的其它属性功能可模仿实现。笔者实现的工具 条控制演练示例程序结果如下:

  

  工具条演练示例结果

 

 

米度软件:www.midosoft.cn