文档介绍：返回
目录
CToolBarCtrl
CToolTipCtrl
CTreeCtrl
CTreeView
CTypedPtrArray
CTypedPtrList
CTypedPtrMap
CUIntArray
CUserException
CView
CWaitCursor
CWinApp
CWindowDC
CWinThread
CWnd
CwordArray
MFC 中的宏和全局函数、变量
宏、全局函数和全局变量
结构、风格、回调函数和消息映射
CToolBarCtrl
CObject
CCmdTarget
CWnd
CTlBarCtrl
CToolBarCtrl 类提供了 Windows 工具条通用控件的性能。这个控件(也就是
CToolBarCtrl 类)只对运行在 Windows 95 和 Windows NT 或更高版本下的
程序来说才是可用的。
一个 Windows 工具条通用控件是一个矩形子窗口,它包含一个或多个按钮。这
些按钮可以显示一个位图图像,一个字符串,或两者都有。当用户选择一个按
钮时,它向该工具条的属主窗口发送一条命令消息。通常,工具条中的按钮对
应于应用程序的菜单中的项;这些按钮为用户访问一个应用程序的命令提供了
更为直接的方法。
CToolBarCtrl 对象包含几个重要的内部数据结构:一个按钮图像列表或一个图
像列表,一个按钮标签字符串列表和一个 TBBUTTON 结构的列表,该结构使
一个图像和/ 或字符串与按钮的位置,风格,主题和命令 ID 相关联。这些数据
结构的每一个都由一个从零开始的索引来引用。在你可以使用一个 CToolBarCtrl
对象之前,你必须设置这些数据结构。字符串列表只能被用作按钮标签;不能
从按钮中检取字符串。
要使用一个 CToolBarCtrl 对象,通常你应该遵循下面的这些步骤:
1. 构造该 CToolBarCtrl 对象。
2. 调用 Create 来创建 Windows 工具条通用控件并将它与该 CToolBarCtrl 对象
连接。通过使用风格来指定工具条的风格,如对一个透明的工具条使用
TBSTYLE_ TRANSPARENT ,或对一个支持风格按钮的工具条使用
TBSTYLE_DROPDOWN。
3. 指明你希望按钮在工具条上如何显示:
l 给按钮使用位图图像,通过调用 AddBitmap 将按钮位图添加到工具条中。
l 给按钮使用来自一个图像列表的图像,通过调用 SetImageList ,
SetHotImageList,或 SetDisabledImageList 来指定图像列表。
l 给按钮使用字符串标签,通过调用 AddString 和/或 AddStrings 来将字符
串添加到工具条中。
4. 通过调用 AddButtons 将按钮结构添加到工具条中。
5. 如果你希望在一个不是 CFrameWnd 的属主窗口中的工具条具有工具提示,
则你必须在工具条的属主窗口中处理 TTN_NEEDTEXT 消息,就像在
CToolBarCtrl:处理工具提示通知中描述的一样。如果工具条的父窗口是
由 CFrameWnd 派生而来的,则你不用作任何额外的努力就可以显示工具
提示,因为 CFrameWnd 提供了一个缺省的处理函数。
6. 如果你希望能够让用户定制工具条,则在属主窗口中处理定制通知消息,
就像在 CToolBarCtrl:处理定制通知中描述的一样。
你可以使用 SaveState 来将一个工具条控件的当前状态保存在注册表中,用
RestoreState 来根据注册表中先前保存的信息恢复工具条的状态。除了在应用程
序的使用之间保存工具条的状态,通常在用户开始定制该工具条之前应用程序
会保存工具条的状态,以防用户后来想将工具条恢复到它的最初的状态。
为 Explorer 或更新版提供的支持
要支持在 Explorer 或更新版之后引入的性能,MFC 提供了图像列表
支持,为工具条提供了透明和平坦风格。
一个透明的工具条允许在工具条下的客户被透过工具条显示出来。要创建一个
透明的工具条,要同时使用 TBSTYLE_FLAT 和 TBSTYLE_TRANSPARENT
风格。透明的工具条具有热点跟踪的特色;就是说,当鼠标指针移动到工具条
的一个热点按钮上时,按钮的外观改变。只用 TBSTYLE_FLAT 风格创建的工
具条将包含不透明的按钮。
图像列表支持使控件的缺省行为具有更大的灵活性,并支持热点