CMFCRibbonGalleryMenuButton Class

Implements a ribbon menu button that contains ribbon galleries.

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Members

Public Constructors

Name

Description

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Constructs and initializes a CMFCRibbonGalleryMenuButton object.

Public Methods

Name

Description

CMFCRibbonGalleryMenuButton::CopyFrom

  (Overrides CMFCToolBarMenuButton::CopyFrom.)

CMFCRibbonGalleryMenuButton::CreatePopupMenu

  (Overrides CMFCToolBarMenuButton::CreatePopupMenu.)

CMFCRibbonGalleryMenuButton::GetPalette

 

CMFCRibbonGalleryMenuButton::HasButton

  (Overrides CMFCToolBarMenuButton::HasButton.)

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

  (Overrides CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

Remarks

The gallery menu button is displayed as a pop-up menu with an arrow. When the user clicks this button, a gallery of images is displayed. When you construct a gallery menu button, you must specify an image list that contains those images.

Example

The following example demonstrates how to display a gallery of bullets in a menu button:

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);
    }
}

Inheritance Hierarchy

CObject   CMFCToolBarButton      CMFCToolBarMenuButton         CMFCRibbonGalleryMenuButton

Requirements

Header: afxRibbonPaletteGallery.h

See Also

Reference

Hierarchy Chart

CMFCToolBarMenuButton Class

CMFCRibbonGallery Class

Other Resources

MFC Classes