CMFCToolBar选件类
CMFCToolBar 选件类类似于 CToolBar选件类，但是，提供用户界面功能附加支持。 其中包括简单的工具栏、工具栏有快捷图像的，大图标、寻呼机按钮、锁定的工具栏、rebar控件、文本在图像下，背景图像和选项卡式工具栏。 CMFCToolBar 选件类还包含内置为工具栏的用户可自定义的支持，并菜单、拖放到工具栏和菜单之间，组合框按钮，编辑框按钮、颜色选取器和汇总按钮。
class CMFCToolBar : public CMFCBaseToolBar
成员
.gif "Bb984480.collapse_all(zh-cn,VS.110).gif")
公共构造函数
名称 |
说明 |
|---|---|
CMFCToolBar::CMFCToolBar |
默认构造函数。 |
CMFCToolBar::~CMFCToolBar |
析构函数。 |
公共方法
名称 |
说明 |
|---|---|
添加一个菜单命令添加到始终显示命令的列表，当用户打开菜单中。 |
|
由一个递增的方式与该特定命令的计数器。 |
|
从用户界面资源将图像添加到图像的集合在应用程序中。 |
|
计算工具栏的大小和位置。 （重写 CBasePane::AdjustLayout）。 |
|
计算工具栏的大小。 |
|
指定文本标签是否可以显示在工具栏按钮的图像下。 |
|
指定在图像下面的文本标签是否在工具栏按钮当前显示。 |
|
启用或禁用非活动按钮图像的自动生成功能。 |
|
返回指定的 CMFCToolBarButton选件类 对象的索引此工具栏上的。 |
|
计算工具栏的水平大小。 （重写 CBasePane::CalcFixedLayout。） |
|
调用由框架作为布局计算过程的一部分。 （重写 CPane::CalcSize。） |
|
确定工具栏和同级是否在同一窗格中确定。 |
|
释放为工具栏图像分配的系统资源。 |
|
释放为锁定的工具栏图像分配的系统资源。 |
|
指定用户是否可以关闭工具栏。 （重写 CBasePane::CanBeClosed。） |
|
确定系统是否能还原工具栏到其原始状态在自定义项之后。 |
|
指定窗格是否可以接收焦点。 （重写 CBasePane::CanFocus。） |
|
确定工具栏和同级是否在同一窗格中确定。 |
|
返回按钮的索引工具栏上的具有指定的命令ID的. |
|
创建一个 CMFCToolBar 对象。 |
|
创建使用附加样式的选项卡中 CMFCToolBar 对象，如大图标。 |
|
停用工具栏。 |
|
启用或禁用显示在工具栏的末尾的 添加或移除按钮按钮。 |
|
启用窗格的停靠到主框架。 （重写 CBasePane::EnableDocking。） |
|
启用或禁用了工具栏按钮的大图标。 |
|
启用或禁用工具栏的快速自定义项，以便用户可以按 Alt 键和按钮拖动到新位置。 |
|
启用或禁用命令反射。 |
|
启用或禁用文本标签在工具栏按钮图像下。 |
|
检索指向包含特定窗口句柄的 CMFCToolBar 对象。 |
|
返回只读列表工具栏中的按钮。 |
|
返回只读列表在应用程序的所有工具栏。 |
|
返回只读在应用程序定义列表的基本命令。 |
|
返回指向具有指定的工具栏按钮索引的 CMFCToolBarButton 对象。 |
|
返回按钮的命令ID、样式和图像索引在指定的索引。 |
|
返回维度工具栏上的每个按钮。 |
|
返回位于指定索引处的工具栏按钮的当前样式。 |
|
返回具有指定的索引按钮的文本标签。 |
|
返回指向冷工具栏按钮图像的集合在应用程序中。 |
|
返回工具栏按钮的宽度。 |
|
返回具有从所有工具栏中指定的命令ID在应用程序按钮的列表。 |
|
返回按钮和分隔符数在工具栏。 |
|
检索指向与工具栏的 CMFCCustomizeButton 对象。 |
|
返回默认图像的索引一个工具栏按钮的具有指定的命令ID的. |
|
返回指向的指针为禁用工具栏按钮使用应用程序图像的集合。 |
|
返回指向的指针为禁用菜单按钮使用应用程序图像的集合。 |
|
检索指向当前显示其子菜单的菜单按钮对象。 |
|
指定禁用按钮的图像是否是普通按钮图像的灰显的版本或将禁用按钮图像的集合。 |
|
返回指向当前显示的工具栏按钮。 |
|
确定工具栏按钮是否快捷跟踪。 |
|
返回所示的工具栏按钮的文本颜色。 |
|
将处理返回给具有输入焦点的窗口，请在工具栏上。 |
|
指定是否调用将按钮标签被忽略。 |
|
返回工具栏按钮图像的当前范围。 |
|
返回指向在应用程序的默认按钮图像的集合。 |
|
返回用于的索引偏移量查找此工具栏的工具栏按钮图像在全局列表工具栏按钮图像。 |
|
检索必须为给定索引的按钮重绘工作区的区域。 |
|
返回工具栏按钮的命令ID在指定的索引。 |
|
返回按钮的边框在指定的索引。 |
|
返回指向用冷工具栏按钮图像的集合在应用程序中。 |
|
返回指向用禁用工具栏按钮图像的集合在应用程序中。 |
|
返回指向用工具栏按钮图像的集合在应用程序中。 |
|
返回指向锁定的冷图像的集合工具栏上的。 |
|
返回指向锁定的禁用图像的集合工具栏上的。 |
|
返回指向锁定的按钮图像的集合工具栏上的。 |
|
返回锁定的工具栏图像的默认大小。 |
|
返回指向锁定的工具栏菜单图像的集合工具栏上的。 |
|
返回菜单按钮的大小在应用程序中。 |
|
返回菜单在应用程序中按钮的图像的大小。 |
|
返回指向菜单在应用程序的按钮图像的集合。 |
|
检索工具栏的非自定义按钮的集合。 |
|
检索工具栏的非自定义的重置按钮的集合。 |
|
检索工具栏的资源ID。 |
|
确定哪个对象、父级框架或所有者，将命令发送到工具栏。 |
|
返回高度工具栏按钮。 |
|
指定工具提示是否为工具栏按钮显示。 |
|
检索工具栏的同级节点。 |
|
返回指向用户定义的工具栏按钮图像的集合在应用程序中。 |
|
返回驻留在指定的位置工具栏按钮的索引。 |
|
插入按钮添加到工具栏中的。 |
|
插入分隔符到工具栏中的。 |
|
无效存在中提供的索引工具栏按钮的工作区。 |
|
确定用户使用 自定义 菜单选项，则可以添加或移除工具栏按钮。 |
|
指定 快速自定义 是否在拖动按钮。 |
|
指定非活动(未显示)按钮图像的自动生成是否启用。 |
|
确定命令是否可以在基本命令列表。 |
|
定位工具栏是否可以显示扩展的边框的按钮。 |
|
确定工具栏上的按钮是否显示。 |
|
确定是否允许命令。 |
|
确定是否很少使用命令(请参见 CMFCToolBar::SetCommandUsageOptions）。 |
|
指定工具栏结构是否在自定义模式。 |
|
确定工具栏按钮是否已拖动。 |
|
定位工具栏是否包含 自定义 按钮。 |
|
确定是否浮动工具栏。 |
|
指定在应用程序的工具栏当前是否显示大图标。 |
|
确定该最近执行的命令是否从指定的工具栏按钮发送了。 |
|
定位工具栏是否锁定。 |
|
确定工具栏和同级工具栏是否在同一行确定。 |
|
指定工具栏是否是用户定义的。 |
|
从应用程序资源加载工具栏图像。 |
|
从应用程序资源加载工具栏图像。 包括大图像。 |
|
从Windows注册表加载全局工具栏选项。 |
|
从Windows注册表加载toolbar状态信息。 （重写 CPane::LoadState。） |
|
从应用程序资源加载工具栏。 |
|
从应用程序资源加载工具栏使用 CMFCToolBarInfo 帮助器选件您的应用程序用图像。 |
|
调用由结构，当用户选择工具栏上的按钮。 |
|
调用从 CBasePane::DoPaint 的framework加载工具栏背景。 |
|
工具栏还原到其原始状态。 |
|
（重写 CBasePane::OnSetAccData。） |
|
还原工具栏按钮的文本设置其默认状态。 |
|
CMFCToolBar::OnUpdateCmdUI |
内部使用。 |
从工具栏中移除所有按钮。 |
|
移除按钮具有指定的索引从工具栏。 |
|
从Windows注册表删除工具栏的状态信息。 |
|
用另一个工具栏按钮替换的工具栏按钮。 |
|
还原所有工具栏到其原始状态。 |
|
清除在应用程序的所有工具栏图像集合。 |
|
还原工具栏的原始状态。 |
|
保存工具栏的状态信息在Windows注册表。 （重写 CPane::SaveState。） |
|
CMFCToolBar::Serialize |
（重写 CBasePane::Serialize。） |
设置始终显示命令的列表，当用户打开菜单中。 |
|
设置工具栏按钮的命令ID、样式和图像ID。 |
|
设置工具栏按钮的样式在给定索引。 |
|
设置工具栏按钮的文本标签。 |
|
设置工具栏上的按钮。 |
|
在很少使用的命令没有出现在应用程序的菜单，指定。 |
|
启动或禁用所有工具栏的自定义模式在应用程序。 |
|
指定在工具栏上禁用按钮是否为灰色，或者禁用图像为禁用的按钮使用。 |
|
设置工具栏按钮的高度。 |
|
指定工具栏按钮是否快捷跟踪。 |
|
设置快捷工具栏按钮的文本颜色。 |
|
指定工具栏按钮是否显示大图标。 |
|
设置锁定的按钮的大小与工具栏上的锁定的图像。 |
|
设置工具栏菜单按钮及其图像的大小。 |
|
设置用户无法执行命令的列表。 |
|
在同一行上定位工具栏及其同级。 |
|
指定用户是否可以关闭工具栏。 |
|
指定父框架或所有者是否将命令发送到工具栏。 |
|
指定框架是否显示工具提示。 |
|
指定工具栏的同级节点。 |
|
在所有工具栏指定按钮的大小和图像。 |
|
在指定工具栏按钮的属性。 |
|
在单独的行上定位工具栏及其同级。 |
|
设置用户定义的图像的集合在应用程序中。 |
|
拉伸水平或垂直工具栏。（重写 CBasePane::StretchPane。） |
|
因此，如果指定的键代码对应于有效的键盘快捷键，执行一个按钮命令。 |
|
更新指定的按钮的状态。 |
|
重新定位在给定维中的工具栏按钮。 |
受保护的方法
名称 |
说明 |
|---|---|
定位工具栏是否在 自定义 对话框的 工具栏 窗格的列表中显示。 |
|
计算一个按钮的最大高度工具栏上的。 |
|
重新绘制一个工具栏。 |
|
重新绘制一个工具栏按钮。 |
|
重新绘制在工具栏的分隔符。 |
|
调用由结构，当按钮的工具提示将显示。 |
数据成员
名称 |
说明 |
|---|---|
在高DPI模式指定是否调用工具栏图像。 |
|
指定在尺寸(高度或宽度)大图像和维度的比例常规映像之间。 |
备注
若要将 CMFCToolBar 对象到应用程序中，请执行以下步骤:
添加一 CMFCToolBar 对象向主框架窗口。
在处理主框架窗口时 WM_CREATE 消息，请调用 CMFCToolBar::Create 或 CMFCToolBar::CreateEx 创建工具栏并指定其样式。
调用 CBasePane::EnableDocking 指定停靠样式。
使用 CMFCToolBar::ReplaceButton，插入一个特定按钮，如组合框或下拉式工具栏，保留一个虚拟的按钮在父资源，并替换虚假的按钮在运行时。 有关更多信息，请参见 演练:将控件放入工具栏。
CMFCToolBar 是MFC库选件类的 CMFCMenuBar选件类、 CMFCPopupMenuBar选件类和 CMFCDropDownToolBar选件类基类。
示例
下面的示例在 CMFCToolBar 选件类演示如何使用各种方法。 此示例演示如何设置工具栏的windows标签的文本，设置边框，设置窗格的样式，从而显示在工具栏的末尾的 添加或移除按钮 按钮。 此代码段是 pocket IE演示示例的一部分。
CMFCToolBar m_wndToolBar;
...
m_wndToolBar.SetWindowText (_T("Standard"));
m_wndToolBar.SetBorders ();
//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));
m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));
要求
标头: afxtoolbar.h