CToolBarCtrl选件类

项目
03/01/2013

提供Windows工具栏公共控件的功能。

class CToolBarCtrl : public CWnd

成员

公共构造函数

名称	说明
服务	构造 CToolBarCtrl 对象。

公共方法

名称	说明
CToolBarCtrl::AddBitmap	添加一个或多个位图按钮图像到按钮图像列表可用于工具栏控件。
CToolBarCtrl::AddButtons	添加一个或多个按钮添加到工具栏控件。
CToolBarCtrl::AddString	添加一个新字符串，作为资源ID，为内部的工具栏上的列表的字符串。
CToolBarCtrl::AddStrings	添加一个新字符串，通过，为Null分隔的字符串缓冲区的指针，对内部的工具栏上的列表的字符串。
CToolBarCtrl::AutoSize	调整工具栏控件。
CToolBarCtrl::ChangeBitmap	更改一个按钮的位图在当前工具栏控件。
CToolBarCtrl::CheckButton	选中或清除在工具栏控件的特定按钮。
CToolBarCtrl::CommandToIndex	检索按钮的从零开始的索引与指定的顺序标识符。
CToolBarCtrl::Create	创建一个工具栏控件并将它附加到 CToolBarCtrl 对象。
CToolBarCtrl::CreateEx	使用指定的Windows扩展的样式创建一个工具栏控件并将它附加到 CToolBarCtrl 对象。
CToolBarCtrl::Customize	显示自定义工具栏"对话框。
CToolBarCtrl::DeleteButton	从控件中删除工具栏按钮。
CToolBarCtrl::EnableButton	启用或禁用了toolbar控件的指定的按钮。
CToolBarCtrl::GetAnchorHighlight	检索设置为工具栏的定位点突出显示。
CToolBarCtrl::GetBitmap	检索位图的索引与工具栏上的按钮。
CToolBarCtrl::GetBitmapFlags	获取标志与工具栏的位图。
CToolBarCtrl::GetButton	检索有关指定的按钮的信息在工具栏控件。
CToolBarCtrl::GetButtonCount	当前检索按钮的计数在工具栏控件。
CToolBarCtrl::GetButtonInfo	检索一个按钮的信息在工具栏。
CToolBarCtrl::GetButtonSize	检索当前宽度和高度工具栏按钮，以像素为单位。
CToolBarCtrl::GetColorScheme	检索当前工具栏控件的配色方案。
CToolBarCtrl::GetDisabledImageList	检索图像列表工具栏控件使用显示禁用的按钮。
CToolBarCtrl::GetDropTarget	检索工具栏控件的 IDropTarget 接口。
CToolBarCtrl::GetExtendedStyle	检索工具栏控件的扩展样式。
CToolBarCtrl::GetHotImageList	检索图像列表工具栏控件使用显示“快捷”按钮。当鼠标指针悬停在上时，一个快捷按钮突出显示。
CToolBarCtrl::GetHotItem	检索快捷项的索引工具栏上的。
CToolBarCtrl::GetImageList	检索图像列表工具栏控件使用显示在其默认状态的按钮。
CToolBarCtrl::GetInsertMark	检索工具栏的当前插入标记。
CToolBarCtrl::GetInsertMarkColor	检索使用的颜色绘制工具栏中插入标记。
CToolBarCtrl::GetItemRect	检索一个按钮的边框在工具栏控件的。
CToolBarCtrl::GetMaxSize	检索所有的总大小可见按钮和分隔符在工具栏。
CToolBarCtrl::GetMaxTextRows	检索文本行的最大数在工具栏按钮公开的。
CToolBarCtrl::GetMetrics	检索工具栏控件的指标。
CToolBarCtrl::GetPadding	检索当前工具栏控件的水平和垂直填充。
CToolBarCtrl::GetPressedImageList	检索图像列出当前工具栏控件使用个表示按下状态的按钮。
CToolBarCtrl::GetRect	检索一个指定的工具栏按钮的边框。
CToolBarCtrl::GetRows	检索行数工具栏当前显示的按钮。
CToolBarCtrl::GetState	检索有关指定的按钮的状态信息在一个工具栏控件，例如是否已启用，按下或签出。
CToolBarCtrl::GetString	检索工具栏字符串。
CToolBarCtrl::GetStyle	检索样式将用于工具栏控件。
CToolBarCtrl::GetToolTips	检索工具提示控件的句柄，如果有，与工具栏控件。
CToolBarCtrl::HideButton	隐藏或显示在工具栏控件的指定的按钮。
CToolBarCtrl::HitTest	确定一个点位置。工具栏控件。
CToolBarCtrl::Indeterminate	设置或清除指定的按钮不确定的(灰色)状态在工具栏控件的。
CToolBarCtrl::InsertButton	插入工具栏中的按钮控件。
CToolBarCtrl::InsertMarkHitTest	检索点插入标记信息在工具栏。
CToolBarCtrl::IsButtonChecked	指示在工具栏控件的指定的按钮是否已选中。
CToolBarCtrl::IsButtonEnabled	指示在工具栏控件的指定的按钮是否启用。
CToolBarCtrl::IsButtonHidden	指示在工具栏控件的指定的按钮是否为隐藏的。
CToolBarCtrl::IsButtonHighlighted	检查工具栏按钮的突出显示状态。
CToolBarCtrl::IsButtonIndeterminate	通知指定的按钮的状态在工具栏控件是否是不确定的(灰色）。
CToolBarCtrl::IsButtonPressed	指示在工具栏控件的指定的按钮是否按。
CToolBarCtrl::LoadImages	加载位图到工具栏控件的图像中列出。
CToolBarCtrl::MapAccelerator	映射快捷键字符为工具栏按钮。
CToolBarCtrl::MarkButton	设置特定按钮的突出显示状态。工具栏控件的。
CToolBarCtrl::MoveButton	从索引按钮移动到另一个。
CToolBarCtrl::PressButton	按或版本在工具栏控件的指定的按钮。
CToolBarCtrl::ReplaceBitmap	用一个新的位图替换在当前工具栏控件的现有的位图。
CToolBarCtrl::RestoreState	还原工具栏控件的状态。
CToolBarCtrl::SaveState	保存工具栏控件的状态。
CToolBarCtrl::SetAnchorHighlight	设置为工具栏的定位点突出显示。
CToolBarCtrl::SetBitmapSize	设置要添加的数字复制图像的大小到工具栏控件。
CToolBarCtrl::SetButtonInfo	将现有按钮的信息在工具栏。
CToolBarCtrl::SetButtonSize	设置要添加的按钮的大小到工具栏控件。
CToolBarCtrl::SetButtonStructSize	指定 TBBUTTON 结构的大小。
CToolBarCtrl::SetButtonWidth	设置在工具栏控件的最小值和最大值按钮宽度。
CToolBarCtrl::SetCmdID	指定的按钮时，设置要发送的命令ID给所有者窗口。
CToolBarCtrl::SetColorScheme	设置当前工具栏控件的配色方案。
CToolBarCtrl::SetDisabledImageList	设置图像列表工具栏控件将使用显示禁用的按钮。
CToolBarCtrl::SetDrawTextFlags	将Win32函数 DrawText，的标志用于绘制在指定的矩形的文本，已设置基于标志如何设置。
CToolBarCtrl::SetExtendedStyle	设置工具栏控件的扩展样式。
CToolBarCtrl::SetHotImageList	设置图像列表工具栏控件将使用显示“快捷”按钮。
CToolBarCtrl::SetHotItem	设置工具栏上的快捷项目。
CToolBarCtrl::SetImageList	设置图像列表工具栏将使用显示其默认状态的按钮。
CToolBarCtrl::SetIndent	将第一个按钮的缩进在工具栏控件。
CToolBarCtrl::SetInsertMark	设置工具栏按钮的当前插入标记。
CToolBarCtrl::SetInsertMarkColor	设置用于的颜色绘制工具栏中插入标记。
CToolBarCtrl::SetMaxTextRows	设置文本行的最大数在工具栏按钮公开的。
CToolBarCtrl::SetMetrics	设置工具栏控件的指标。
CToolBarCtrl::SetOwner	设置窗口接收从工具栏控件的通知消息。
CToolBarCtrl::SetPadding	设置当前工具栏控件的水平和垂直填充。
CToolBarCtrl::SetPressedImageList	设置图像列出当前工具栏控件使用个表示按下状态的按钮。
CToolBarCtrl::SetRows	设置要在工具栏上显示的按钮。
CToolBarCtrl::SetState	设置指定的按钮的状态在工具栏控件。
CToolBarCtrl::SetStyle	设置工具栏控件的样式。
CToolBarCtrl::SetToolTips	关联工具提示控件与工具栏控件。
CToolBarCtrl::SetWindowTheme	设置工具栏控件的视觉样式。

备注

此控件(并 CToolBarCtrl 选件类)若要在运行Windows 95 /98和Windows NT 3.51版下的程序可用和更高版本。

Windows工具栏公共控件。包含一个或多个按钮的矩形子窗口。这些按钮可以显示位图图像，字符串或两个。当用户选择该按钮时，其发送命令信息到工具栏的所有者窗口。通常，在工具栏上的按钮对应于应用程序的菜单中的项;它们提供直接访问方式应用程序的命令。

CToolBarCtrl 对象包含几个重要内部数据结构:按钮位图图像列表或图像列表，按钮标签字符串列表和的 TBBUTTON 结构列表关联图像和字符串包含按钮的位置、样式、状态和命令ID。每个这些数据结构组件的从零开始的索引引用。在使用 CToolBarCtrl 对象之前，您必须将这些数据结构。字符串列表可以为该按钮标签只使用;不能从工具栏检索字符串。

若要使用 CToolBarCtrl 对象，则通常执行以下步骤:

构造 CToolBarCtrl 对象。
调用创建创建工具栏Windows公共控件并将其附加到 CToolBarCtrl 对象。指示工具栏样式使用样式，例如透明工具栏的支持下拉式样式按钮的工具栏上的 TBSTYLE_TRANSPARENT 或 TBSTYLE_DROPDOWN。
标识您希望在显示的工具栏中的按钮:
- 为按钮若要使用位图图像，添加按钮位图到工具栏通过调用 AddBitmap。
- 若要使用图像显示的图像。按钮列表中，指定图像通过调用 SetImageList、 SetHotImageList或 SetDisabledImageList列表。
- 为按钮若要使用字符串标签，请添加到工具栏通过调用 AddString 和 AddStrings。
添加按钮结构到工具栏通过调用 AddButtons。
如果希望工具栏的工具提示在不是 CFrameWnd的所有者窗口，则按需要处理工具栏上的所有者窗口的 TTN_NEEDTEXT 消息处理工具提示通知如中所述。如果工具栏的父窗口 CFrameWnd从派生，工具提示显示，而无需从您的任何执行任何额外的工作，因为 CFrameWnd 提供了默认的处理程序。
如果您希望您的用户可以自定义工具栏，处理自定义在所有者窗口的通知消息。处理自定义通知所述。

可以使用 SaveState 保存一个工具栏控件的当前状态在注册表中 RestoreState 的恢复信息的状态以前存储在注册表。除了保存到应用程序中使用的之间toolbar状态外，应用程序通常存储为状态，在用户开始自定义工具栏之前，以防用户后若要还原工具栏到其原始状态。

对于Internet Explorer 4.0版和更高版本支持

若要支持在Internet Explorer中引入的功能，版本4.0和更高版本，MFC提供图像列表支持和工具栏控件的透明和平面样式。

透明工具栏允许客户端在工具栏下方通过显示。若要创建透明工具栏中，使用 TBSTYLE_FLAT 和 TBSTYLE_TRANSPARENT 样式。透明工具栏在快捷跟踪功能;也就是说，当鼠标指针移动到在"工具栏中的快捷按钮，该按钮的外观更改。在 TBSTYLE_FLAT 样式创建的工具栏将包含不透明的按钮。

图像列表支持控件的默认行为、快捷图像和禁用图像的更大的灵活性。使用 GetImageList、 GetHotImageList和 GetDisabledImageList 以透明工具栏根据自身的状态操作图像:

有关使用 CToolBarCtrl的更多信息，请参见控件和使用CToolBarCtrl。