CMFCRibbonMiniToolBar 类

项目
10/16/2023

实现上下文快捷工具栏。

语法

class CMFCRibbonMiniToolBar : public CMFCRibbonPanelMenu

成员

公共构造函数

名称	描述
`CMFCRibbonMiniToolBar::CMFCRibbonMiniToolBar`	默认构造函数。
`CMFCRibbonMiniToolBar::~CMFCRibbonMiniToolBar`	析构函数。

公共方法

名称	描述
`CMFCRibbonMiniToolBar::CreateObject`	由框架用于创建此类类型的动态实例。
`CMFCRibbonMiniToolBar::GetThisClass`	由框架用于获取指向与此类类型关联的 CRuntimeClass 对象的指针。
CMFCRibbonMiniToolBar::IsContextMenuMode
CMFCRibbonMiniToolBar::IsRibbonMiniToolBar	（替代 `CMFCPopupMenu::IsRibbonMiniToolBar`。）
CMFCRibbonMiniToolBar::SetCommands	设置要在工具栏上显示的命令的列表。
CMFCRibbonMiniToolBar::Show	在指定的屏幕坐标上显示浮动工具栏。
CMFCRibbonMiniToolBar::ShowWithContextMenu	显示浮动工具栏以及上下文菜单。

备注

通常于用户在文档中选择对象后显示浮动工具栏。例如，用户在文字处理程序中选择文本块后，应用程序将显示包含文本格式设置命令的浮动工具栏。

鼠标指针位于浮动工具栏边界之外时，浮动工具栏将变透明。

继承层次结构

CMFCRibbonPanelMenu

CMFCRibbonMiniToolBar

要求

标头：afxRibbonMiniToolBar.h

CMFCRibbonMiniToolBar::SetCommands

设置要在工具栏上显示的命令的列表。

void SetCommands(
    CMFCRibbonBar* pRibbonBar,
    const CList<UINT,UINT>& lstCommands);

参数

pRibbonBar
[in] 微型工具栏在其中搜索要显示的按钮的功能区栏。

lstCommands
[in] 要在微型工具栏上显示的命令列表。将搜索所有功能区类别以查找关联的按钮。

注解

使用此函数设置要在微型工具栏上显示的命令列表。

示例

下面的示例演示如何使用 CMFCRibbonMiniToolBar 类的 SetCommands 方法。此代码片段是 MS Office 2007 演示示例的一部分。

// CMFCRibbonMiniToolBar* pFloaty
CList<UINT, UINT> lstCmds;

lstCmds.AddTail(ID_FONT_FONT);
lstCmds.AddTail(ID_FONT_FONTSIZE);
lstCmds.AddTail(ID_FONT_GROWFONT);
lstCmds.AddTail(ID_FONT_SHRINK);
lstCmds.AddTail(ID_WRITE_CHANGESTYLES);
lstCmds.AddTail(ID_EDIT_COPYFORMAT);
lstCmds.AddTail(ID_FONT_BOLD);
lstCmds.AddTail(ID_FONT_ITALIC);
lstCmds.AddTail(ID_PARA_CENTER);
lstCmds.AddTail(ID_FONT_TEXTHIGHLIGHT);
lstCmds.AddTail(ID_FONT_COLOR);
lstCmds.AddTail(ID_PARA_DECREASEINDENT);
lstCmds.AddTail(ID_PARA_INCREASEINDENT);
lstCmds.AddTail(ID_PARA_BULLETS);

pFloaty->SetCommands(((CMainFrame*)GetTopLevelFrame())->GetRibbonBar(), lstCmds);

CMFCRibbonMiniToolBar::Show

在指定的屏幕坐标上显示浮动工具栏。

BOOL Show(
    int x,
    int y);

参数

x
[in] 指定微型工具栏在屏幕坐标中的水平位置。

y
[in] 指定微型工具栏在屏幕坐标中的垂直位置。

返回值

如果成功显示微型工具栏，则为 TRUE；否则为 FALSE。

CMFCRibbonMiniToolBar::ShowWithContextMenu

显示浮动工具栏以及上下文菜单。

BOOL ShowWithContextMenu(
    int x,
    int y,
    UINT uiMenuResID,
    CWnd* pWndOwner);

参数

x
[in] 指定上下文菜单在屏幕坐标中的水平位置。

y
[in] 指定上下文菜单在屏幕坐标中的垂直位置。

uiMenuResID
[in] 指定要显示的上下文菜单的资源 ID。

pWndOwner
[in] 标识接收来自上下文菜单的消息的窗口。

返回值

如果成功显示上下文菜单，则为 TRUE；否则为 FALSE。

注解

使用此函数可显示具有上下文菜单的微型工具栏。上下文菜单位于微型工具栏下方 15 像素处。

CMFCRibbonMiniToolBar::IsContextMenuMode

有关详细信息，请参阅所安装的 Visual Studio 的 C\atlmfc\src\mfc 文件夹中的源代码。

BOOL IsContextMenuMode() const;

返回值

备注

CMFCRibbonMiniToolBar::IsRibbonMiniToolBar