CMFCRibbonGallery选件类

项目
03/01/2013

实现Office 2007样式功能区库。

class CMFCRibbonGallery : public CMFCRibbonButton

成员

公共构造函数

名称	说明
CMFCRibbonGallery::CMFCRibbonGallery	构造和初始化 CMFCRibbonGallery 对象。

公共方法

名称	说明
CMFCRibbonGallery::AddGroup	添加新组到该库。
CMFCRibbonGallery::AddSubItem	添加新菜单项添加到下拉菜单。
CMFCRibbonGallery::Clear	清除该目录该库。
CMFCRibbonGallery::EnableMenuResize	启用或禁用调整菜单面板。
CMFCRibbonGallery::EnableMenuSideBar	在该弹出菜单左侧启用或禁用该栏。
CMFCRibbonGallery::GetCompactSize	（重写 CMFCRibbonButton::GetCompactSize。）
CMFCRibbonGallery::GetDroppedDown	（重写 CMFCRibbonBaseElement::GetDroppedDown。）
CMFCRibbonGallery::GetGroupName	返回位于指定索引处的组的名称。
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow	顺序返回项的数目功能区库。
CMFCRibbonGallery::GetItemToolTip	返回与该库的项目的工具提示文本。
CMFCRibbonGallery::GetLastSelectedItem	返回最后一项的索引在用户选择的库中。
CMFCRibbonGallery::GetPaletteID	返回当前库的命令ID。
CMFCRibbonGallery::GetRegularSize	（重写 CMFCRibbonButton::GetRegularSize。）
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu	（重写 CMFCRibbonButton::HasMenu。）
CMFCRibbonGallery::IsButtonMode	指定该库是否在库包含按钮。
CMFCRibbonGallery::IsMenuResizeEnabled	指定调整大小的菜单是否启用或禁用。
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar	指定该栏是否启用或禁用。
CMFCRibbonGallery::OnAfterChangeRect	（重写 CMFCRibbonButton::OnAfterChangeRect。）
CMFCRibbonGallery::OnDraw	（重写 CMFCRibbonButton::OnDraw。）
CMFCRibbonGallery::OnEnable	（重写 CMFCRibbonBaseElement::OnEnable。）
CMFCRibbonGallery::OnRTLChanged	（重写 CMFCRibbonBaseElement::OnRTLChanged。）
CMFCRibbonGallery::RedrawIcons	重绘该库。
CMFCRibbonGallery::RemoveItemToolTips	从某个库中的所有项目中移除工具提示。
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData	（重写 CMFCRibbonButton::SetACCData。）
CMFCRibbonGallery::SetButtonMode	指定是否显示了功能区库作为一个下拉式按钮或作为一个调色板直接在功能区。
CMFCRibbonGallery::SetGroupName	设置组的名称。
CMFCRibbonGallery::SetIconsInRow	定义项的数目每在库中的行。
CMFCRibbonGallery::SetItemToolTip	设置一个项目的工具提示文本在该库。
CMFCRibbonGallery::SetPalette	附加调色板到功能区库。
CMFCRibbonGallery::SetPaletteID	定义在 WM_COMMAND 消息发送的命令ID，当库项目选中时。

受保护的方法

名称	说明
CMFCRibbonGallery::OnDrawPaletteIcon	调用由结构，在绘制库图标。

备注

库按钮行为与标准菜单按钮，但它显示库，当用户打开它。当您在中选择库项目时，框架与按钮的命令ID一起发送 WM_COMMAND 信息。在处理消息，应调用 CMFCRibbonGallery::GetLastSelectedItem 确定哪个项目从该库中选择。

示例

下面的示例在 CMFCRibbonGallery 选件类演示如何使用各种方案配置 CMFCRibbonGallery 对象。示例的名称说明如何指定项的数目每一行，启用调整菜单面板，在弹出菜单左侧启用栏和显示了功能区库如调色板直接在功能区栏。此代码段是绘制客户端示例的一部分。

    CMFCRibbonGallery* pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
    pBtnStyles->SetIconsInRow(7);
    pBtnStyles->EnableMenuResize(TRUE, TRUE);
    pBtnStyles->EnableMenuSideBar();
    pBtnStyles->SetButtonMode(false);
    pBtnStyles->RedrawIcons();