CMFCRibbonGalleryMenuButton 类

项目
10/16/2023

实现包含功能区库的功能区菜单按钮。有关详细信息，请参阅所安装的 Visual Studio 的 C\atlmfc\src\mfc 文件夹中的源代码。

语法

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

成员

公共构造函数

名称	描述
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton	构造并初始化一个 `CMFCRibbonGalleryMenuButton` 对象。

公共方法

名称	描述
CMFCRibbonGalleryMenuButton::CopyFrom	（替代 CMFCToolBarMenuButton::CopyFrom。）
CMFCRibbonGalleryMenuButton::CreatePopupMenu	（替代 CMFCToolBarMenuButton::CreatePopupMenu。）
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton	（替代 `CMFCToolBarMenuButton::HasButton`。）
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed	（替代 CMFCToolBarMenuButton::IsEmptyMenuAllowed。）

备注

库菜单按钮显示为带箭头的弹出菜单。用户单击此按钮时，会显示图像库。构造库菜单按钮时，必须指定包含这些图像的图像列表。

示例

下面的示例演示如何采用菜单按钮显示项目符号库：

BOOL CMainFrame::OnShowPopupMenu (CMFCPopupMenu* pMenuPopup)
{
    int nBulletIndex = pMenuBar->CommandToIndex (ID_PARA_BULLETS);

    if (nBulletIndex>= 0)
    {
        CMFCToolBarButton* pExButton =
        pMenuBar->GetButton(nBulletIndex);
        ASSERT_VALID (pExButton);

        CMFCRibbonGalleryMenuButton paletteBullet (
        pExButton->m_nID,
        pExButton->GetImage (),
        pExButton->m_strText);

        InitBulletPalette (&paletteBullet.GetPalette ());

        pMenuBar->ReplaceButton (ID_PARA_BULLETS,
        paletteBullet);
    }
}

继承层次结构

CObject
└ CMFCToolBarButton
└ CMFCToolBarMenuButton
└ CMFCRibbonGalleryMenuButton

要求

标头：afxribbonpalettegallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

参数

[in] src

备注

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

构造并初始化 CMFCRibbonGalleryMenuButton 对象。

CMFCRibbonGalleryMenuButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGalleryMenuButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText,
    UINT uiImagesPaletteResID = 0,
    int cxPaletteImage = 0);

参数

uiID
按钮的命令 ID。这是用户单击此按钮时在 WM_COMMAND 消息中发送的值。

iImage
使用库菜单按钮显示的图像的索引。图像存储在 imagesPalette 参数中。

lpszText
要在菜单按钮上显示的文本。

imagesPalette
包含要在库中显示的图像列表。

uiImagesPaletteResID
要在库中显示的图像的图像列表的资源 ID。

cxPaletteImage
指定要在库中显示的图像的宽度（以像素为单位）。

备注

库菜单按钮显示为带箭头的弹出菜单。用户单击此按钮时，会显示图像库。

示例

以下示例演示了如何使用 CMFCRibbonGalleryMenuButton 类的构造函数。此代码片段是 MS Office 2007 演示示例的一部分。

// CMFCToolBarButton pExButton
CMFCRibbonGalleryMenuButton paletteBullet(pExButton->m_nID, pExButton->GetImage(), pExButton->m_strText);

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

返回值

备注

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

返回值

备注

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

返回值

备注

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

返回值

注解

另请参阅

层次结构图
 类
 CMFCToolBarMenuButton 类
 CMFCRibbonGallery 类

通过