CMFCToolBar选件类

CMFCToolBar 选件类类似于 CToolBar选件类,但是,提供用户界面功能附加支持。 其中包括简单的工具栏、工具栏有快捷图像的,大图标、寻呼机按钮、锁定的工具栏、rebar控件、文本在图像下,背景图像和选项卡式工具栏。 CMFCToolBar 选件类还包含内置为工具栏的用户可自定义的支持,并菜单、拖放到工具栏和菜单之间,组合框按钮,编辑框按钮、颜色选取器和汇总按钮。

class CMFCToolBar : public CMFCBaseToolBar

成员

Bb984480.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CMFCToolBar::CMFCToolBar

默认构造函数。

CMFCToolBar::~CMFCToolBar

析构函数。

Bb984480.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

CMFCToolBar::AddBasicCommand

添加一个菜单命令添加到始终显示命令的列表,当用户打开菜单中。

CMFCToolBar::AddCommandUsage

由一个递增的方式与该特定命令的计数器。

CMFCToolBar::AddToolBarForImageCollection

从用户界面资源将图像添加到图像的集合在应用程序中。

CMFCToolBar::AdjustLayout

计算工具栏的大小和位置。 (重写 CBasePane::AdjustLayout)。

CMFCToolBar::AdjustSize

计算工具栏的大小。

CMFCToolBar::AllowChangeTextLabels

指定文本标签是否可以显示在工具栏按钮的图像下。

CMFCToolBar::AreTextLabels

指定在图像下面的文本标签是否在工具栏按钮当前显示。

CMFCToolBar::AutoGrayInactiveImages

启用或禁用非活动按钮图像的自动生成功能。

CMFCToolBar::ButtonToIndex

返回指定的 CMFCToolBarButton选件类 对象的索引此工具栏上的。

CMFCToolBar::CalcFixedLayout

计算工具栏的水平大小。 (重写 CBasePane::CalcFixedLayout。)

CMFCToolBar::CalcSize

调用由框架作为布局计算过程的一部分。 (重写 CPane::CalcSize。)

CMFCToolBar::CanHandleSiblings

确定工具栏和同级是否在同一窗格中确定。

CMFCToolBar::CleanUpImages

释放为工具栏图像分配的系统资源。

CMFCToolBar::CleanUpLockedImages

释放为锁定的工具栏图像分配的系统资源。

CMFCToolBar::CanBeClosed

指定用户是否可以关闭工具栏。 (重写 CBasePane::CanBeClosed。)

CMFCToolBar::CanBeRestored

确定系统是否能还原工具栏到其原始状态在自定义项之后。

CMFCToolBar::CanFocus

指定窗格是否可以接收焦点。 (重写 CBasePane::CanFocus。)

CMFCToolBar::CanHandleSiblings

确定工具栏和同级是否在同一窗格中确定。

CMFCToolBar::CommandToIndex

返回按钮的索引工具栏上的具有指定的命令ID的.

CMFCToolBar::Create

创建一个 CMFCToolBar 对象。

CMFCToolBar::CreateEx

创建使用附加样式的选项卡中 CMFCToolBar 对象,如大图标。

CMFCToolBar::Deactivate

停用工具栏。

CMFCToolBar::EnableCustomizeButton

启用或禁用显示在工具栏的末尾的 添加或移除按钮按钮。

CMFCToolBar::EnableDocking

启用窗格的停靠到主框架。 (重写 CBasePane::EnableDocking。)

CMFCToolBar::EnableLargeIcons

启用或禁用了工具栏按钮的大图标。

CMFCToolBar::EnableQuickCustomization

启用或禁用工具栏的快速自定义项,以便用户可以按 Alt 键和按钮拖动到新位置。

CMFCToolBar::EnableReflections

启用或禁用命令反射。

CMFCToolBar::EnableTextLabels

启用或禁用文本标签在工具栏按钮图像下。

CMFCToolBar::FromHandlePermanent

检索指向包含特定窗口句柄的 CMFCToolBar 对象。

CMFCToolBar::GetAllButtons

返回只读列表工具栏中的按钮。

CMFCToolBar::GetAllToolbars

返回只读列表在应用程序的所有工具栏。

CMFCToolBar::GetBasicCommands

返回只读在应用程序定义列表的基本命令。

CMFCToolBar::GetButton

返回指向具有指定的工具栏按钮索引的 CMFCToolBarButton 对象。

CMFCToolBar::GetButtonInfo

返回按钮的命令ID、样式和图像索引在指定的索引。

CMFCToolBar::GetButtonSize

返回维度工具栏上的每个按钮。

CMFCToolBar::GetButtonStyle

返回位于指定索引处的工具栏按钮的当前样式。

CMFCToolBar::GetButtonText

返回具有指定的索引按钮的文本标签。

CMFCToolBar::GetColdImages

返回指向冷工具栏按钮图像的集合在应用程序中。

CMFCToolBar::GetColumnWidth

返回工具栏按钮的宽度。

CMFCToolBar::GetCommandButtons

返回具有从所有工具栏中指定的命令ID在应用程序按钮的列表。

CMFCToolBar::GetCount

返回按钮和分隔符数在工具栏。

CMFCToolBar::GetCustomizeButton

检索指向与工具栏的 CMFCCustomizeButton 对象。

CMFCToolBar::GetDefaultImage

返回默认图像的索引一个工具栏按钮的具有指定的命令ID的.

CMFCToolBar::GetDisabledImages

返回指向的指针为禁用工具栏按钮使用应用程序图像的集合。

CMFCToolBar::GetDisabledMenuImages

返回指向的指针为禁用菜单按钮使用应用程序图像的集合。

CMFCToolBar::GetDroppedDownMenu

检索指向当前显示其子菜单的菜单按钮对象。

CMFCToolBar::GetGrayDisabledButtons

指定禁用按钮的图像是否是普通按钮图像的灰显的版本或将禁用按钮图像的集合。

CMFCToolBar::GetHighlightedButton

返回指向当前显示的工具栏按钮。

CMFCToolBar::GetHotBorder

确定工具栏按钮是否快捷跟踪。

CMFCToolBar::GetHotTextColor

返回所示的工具栏按钮的文本颜色。

CMFCToolBar::GetHwndLastFocus

将处理返回给具有输入焦点的窗口,请在工具栏上。

CMFCToolBar::GetIgnoreSetText

指定是否调用将按钮标签被忽略。

CMFCToolBar::GetImageSize

返回工具栏按钮图像的当前范围。

CMFCToolBar::GetImages

返回指向在应用程序的默认按钮图像的集合。

CMFCToolBar::GetImagesOffset

返回用于的索引偏移量查找此工具栏的工具栏按钮图像在全局列表工具栏按钮图像。

CMFCToolBar::GetInvalidateItemRect

检索必须为给定索引的按钮重绘工作区的区域。

CMFCToolBar::GetItemID

返回工具栏按钮的命令ID在指定的索引。

CMFCToolBar::GetItemRect

返回按钮的边框在指定的索引。

CMFCToolBar::GetLargeColdImages

返回指向用冷工具栏按钮图像的集合在应用程序中。

CMFCToolBar::GetLargeDisabledImages

返回指向用禁用工具栏按钮图像的集合在应用程序中。

CMFCToolBar::GetLargeImages

返回指向用工具栏按钮图像的集合在应用程序中。

CMFCToolBar::GetLockedColdImages

返回指向锁定的冷图像的集合工具栏上的。

CMFCToolBar::GetLockedDisabledImages

返回指向锁定的禁用图像的集合工具栏上的。

CMFCToolBar::GetLockedImages

返回指向锁定的按钮图像的集合工具栏上的。

CMFCToolBar::GetLockedImageSize

返回锁定的工具栏图像的默认大小。

CMFCToolBar::GetLockedMenuImages

返回指向锁定的工具栏菜单图像的集合工具栏上的。

CMFCToolBar::GetMenuButtonSize

返回菜单按钮的大小在应用程序中。

CMFCToolBar::GetMenuImageSize

返回菜单在应用程序中按钮的图像的大小。

CMFCToolBar::GetMenuImages

返回指向菜单在应用程序的按钮图像的集合。

CMFCToolBar::GetOrigButtons

检索工具栏的非自定义按钮的集合。

CMFCToolBar::GetOrigResetButtons

检索工具栏的非自定义的重置按钮的集合。

CMFCToolBar::GetResourceID

检索工具栏的资源ID。

CMFCToolBar::GetRouteCommandsViaFrame

确定哪个对象、父级框架或所有者,将命令发送到工具栏。

CMFCToolBar::GetRowHeight

返回高度工具栏按钮。

CMFCToolBar::GetShowTooltips

指定工具提示是否为工具栏按钮显示。

CMFCToolBar::GetSiblingToolBar

检索工具栏的同级节点。

CMFCToolBar::GetUserImages

返回指向用户定义的工具栏按钮图像的集合在应用程序中。

CMFCToolBar::HitTest

返回驻留在指定的位置工具栏按钮的索引。

CMFCToolBar::InsertButton

插入按钮添加到工具栏中的。

CMFCToolBar::InsertSeparator

插入分隔符到工具栏中的。

CMFCToolBar::InvalidateButton

无效存在中提供的索引工具栏按钮的工作区。

CMFCToolBar::IsAddRemoveQuickCustomize

确定用户使用 自定义 菜单选项,则可以添加或移除工具栏按钮。

CMFCToolBar::IsAltCustomizeMode

指定 快速自定义 是否在拖动按钮。

CMFCToolBar::IsAutoGrayInactiveImages

指定非活动(未显示)按钮图像的自动生成是否启用。

CMFCToolBar::IsBasicCommand

确定命令是否可以在基本命令列表。

CMFCToolBar::IsButtonExtraSizeAvailable

定位工具栏是否可以显示扩展的边框的按钮。

CMFCToolBar::IsButtonHighlighted

确定工具栏上的按钮是否显示。

CMFCToolBar::IsCommandPermitted

确定是否允许命令。

CMFCToolBar::IsCommandRarelyUsed

确定是否很少使用命令(请参见 CMFCToolBar::SetCommandUsageOptions)。

CMFCToolBar::IsCustomizeMode

指定工具栏结构是否在自定义模式。

CMFCToolBar::IsDragButton

确定工具栏按钮是否已拖动。

CMFCToolBar::IsExistCustomizeButton

定位工具栏是否包含 自定义 按钮。

CMFCToolBar::IsFloating

确定是否浮动工具栏。

CMFCToolBar::IsLargeIcons

指定在应用程序的工具栏当前是否显示大图标。

CMFCToolBar::IsLastCommandFromButton

确定该最近执行的命令是否从指定的工具栏按钮发送了。

CMFCToolBar::IsLocked

定位工具栏是否锁定。

CMFCToolBar::IsOneRowWithSibling

确定工具栏和同级工具栏是否在同一行确定。

CMFCToolBar::IsUserDefined

指定工具栏是否是用户定义的。

CMFCToolBar::LoadBitmap

从应用程序资源加载工具栏图像。

CMFCToolBar::LoadBitmapEx

从应用程序资源加载工具栏图像。 包括大图像。

CMFCToolBar::LoadParameters

从Windows注册表加载全局工具栏选项。

CMFCToolBar::LoadState

从Windows注册表加载toolbar状态信息。 (重写 CPane::LoadState。)

CMFCToolBar::LoadToolBar

从应用程序资源加载工具栏。

CMFCToolBar::LoadToolBarEx

从应用程序资源加载工具栏使用 CMFCToolBarInfo 帮助器选件您的应用程序用图像。

CMFCToolBar::OnChangeHot

调用由结构,当用户选择工具栏上的按钮。

CMFCToolBar::OnFillBackground

调用从 CBasePane::DoPaint 的framework加载工具栏背景。

CMFCToolBar::OnReset

工具栏还原到其原始状态。

CMFCToolBar::OnSetAccData

 (重写 CBasePane::OnSetAccData。)

CMFCToolBar::OnSetDefaultButtonText

还原工具栏按钮的文本设置其默认状态。

CMFCToolBar::OnUpdateCmdUI

内部使用。

CMFCToolBar::RemoveAllButtons

从工具栏中移除所有按钮。

CMFCToolBar::RemoveButton

移除按钮具有指定的索引从工具栏。

CMFCToolBar::RemoveStateFromRegistry

从Windows注册表删除工具栏的状态信息。

CMFCToolBar::ReplaceButton

用另一个工具栏按钮替换的工具栏按钮。

CMFCToolBar::ResetAll

还原所有工具栏到其原始状态。

CMFCToolBar::ResetAllImages

清除在应用程序的所有工具栏图像集合。

CMFCToolBar::RestoreOriginalstate

还原工具栏的原始状态。

CMFCToolBar::SaveState

保存工具栏的状态信息在Windows注册表。 (重写 CPane::SaveState。)

CMFCToolBar::Serialize

 (重写 CBasePane::Serialize。)

CMFCToolBar::SetBasicCommands

设置始终显示命令的列表,当用户打开菜单中。

CMFCToolBar::SetButtonInfo

设置工具栏按钮的命令ID、样式和图像ID。

CMFCToolBar::SetButtonStyle

设置工具栏按钮的样式在给定索引。

CMFCToolBar::SetButtonText

设置工具栏按钮的文本标签。

CMFCToolBar::SetButtons

设置工具栏上的按钮。

CMFCToolBar::SetCommandUsageOptions

在很少使用的命令没有出现在应用程序的菜单,指定。

CMFCToolBar::SetCustomizeMode

启动或禁用所有工具栏的自定义模式在应用程序。

CMFCToolBar::SetGrayDisabledButtons

指定在工具栏上禁用按钮是否为灰色,或者禁用图像为禁用的按钮使用。

CMFCToolBar::SetHeight

设置工具栏按钮的高度。

CMFCToolBar::SetHotBorder

指定工具栏按钮是否快捷跟踪。

CMFCToolBar::SetHotTextColor

设置快捷工具栏按钮的文本颜色。

CMFCToolBar::SetLargeIcons

指定工具栏按钮是否显示大图标。

CMFCToolBar::SetLockedSizes

设置锁定的按钮的大小与工具栏上的锁定的图像。

CMFCToolBar::SetMenuSizes

设置工具栏菜单按钮及其图像的大小。

CMFCToolBar::SetNonPermittedCommands

设置用户无法执行命令的列表。

CMFCToolBar::SetOneRowWithSibling

在同一行上定位工具栏及其同级。

CMFCToolBar::SetPermament

指定用户是否可以关闭工具栏。

CMFCToolBar::SetRouteCommandsViaFrame

指定父框架或所有者是否将命令发送到工具栏。

CMFCToolBar::SetShowTooltips

指定框架是否显示工具提示。

CMFCToolBar::SetSiblingToolBar

指定工具栏的同级节点。

CMFCToolBar::SetSizes

在所有工具栏指定按钮的大小和图像。

CMFCToolBar::SetToolBarBtnText

在指定工具栏按钮的属性。

CMFCToolBar::SetTwoRowsWithSibling

在单独的行上定位工具栏及其同级。

CMFCToolBar::SetUserImages

设置用户定义的图像的集合在应用程序中。

CMFCToolBar::StretchPane

拉伸水平或垂直工具栏。(重写 CBasePane::StretchPane。)

CMFCToolBar::TranslateChar

因此,如果指定的键代码对应于有效的键盘快捷键,执行一个按钮命令。

CMFCToolBar::UpdateButton

更新指定的按钮的状态。

CMFCToolBar::WrapToolBar

重新定位在给定维中的工具栏按钮。

Bb984480.collapse_all(zh-cn,VS.110).gif受保护的方法

名称

说明

CMFCToolBar::AllowShowOnList

定位工具栏是否在 自定义 对话框的 工具栏 窗格的列表中显示。

CMFCToolBar::CalcMaxButtonHeight

计算一个按钮的最大高度工具栏上的。

CMFCToolBar::DoPaint

重新绘制一个工具栏。

CMFCToolBar::DrawButton

重新绘制一个工具栏按钮。

CMFCToolBar::DrawSeparator

重新绘制在工具栏的分隔符。

CMFCToolBar::OnUserToolTip

调用由结构,当按钮的工具提示将显示。

Bb984480.collapse_all(zh-cn,VS.110).gif数据成员

名称

说明

CMFCToolBar::m_bDontScaleImages

在高DPI模式指定是否调用工具栏图像。

CMFCToolBar::m_dblLargeImageRatio

指定在尺寸(高度或宽度)大图像和维度的比例常规映像之间。

备注

若要将 CMFCToolBar 对象到应用程序中,请执行以下步骤:

  1. 添加一 CMFCToolBar 对象向主框架窗口。

  2. 在处理主框架窗口时 WM_CREATE 消息,请调用 CMFCToolBar::CreateCMFCToolBar::CreateEx 创建工具栏并指定其样式。

  3. 调用 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

继承层次结构

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CMFCBaseToolBar

                  CMFCToolBar

请参见

任务

演练:将控件放入工具栏

参考

层次结构图

CMFCMenuBar选件类

CMFCPopupMenuBar选件类

CMFCDropDownToolBar选件类

其他资源

MFC 类