CMFCRibbonGallery Class

Implements Office 2007-style ribbon galleries.

class CMFCRibbonGallery : public CMFCRibbonButton

Members

Public Constructors

Name	Description
CMFCRibbonGallery::CMFCRibbonGallery	Constructs and initializes a CMFCRibbonGallery object.

Public Methods

Name	Description
CMFCRibbonGallery::AddGroup	Adds a new group to the gallery.
CMFCRibbonGallery::AddSubItem	Adds a new menu item to the drop-down menu.
CMFCRibbonGallery::Clear	Clears the content of the gallery.
CMFCRibbonGallery::EnableMenuResize	Enables or disables resizing of the menu panel.
CMFCRibbonGallery::EnableMenuSideBar	Enables or disables the side bar to the left of the popup menu.
CMFCRibbonGallery::GetCompactSize	(Overrides CMFCRibbonButton::GetCompactSize.)
CMFCRibbonGallery::GetDroppedDown	(Overrides CMFCRibbonBaseElement::GetDroppedDown.)
CMFCRibbonGallery::GetGroupName	Returns the name of the group that is located at the specified index.
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow	Returns the number of items in a row of the ribbon gallery.
CMFCRibbonGallery::GetItemToolTip	Returns the tooltip text that is associated with an item in the gallery.
CMFCRibbonGallery::GetLastSelectedItem	Returns the index of the last item in the gallery that the user selected.
CMFCRibbonGallery::GetPaletteID	Returns the command ID of the current gallery.
CMFCRibbonGallery::GetRegularSize	(Overrides CMFCRibbonButton::GetRegularSize.)
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu	(Overrides CMFCRibbonButton::HasMenu.)
CMFCRibbonGallery::IsButtonMode	Specifies whether the gallery is contained in a gallery button.
CMFCRibbonGallery::IsMenuResizeEnabled	Specifies whether menu resizing is enabled or disabled.
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar	Specifies whether the side bar is enabled or disabled.
CMFCRibbonGallery::OnAfterChangeRect	(Overrides CMFCRibbonButton::OnAfterChangeRect.)
CMFCRibbonGallery::OnDraw	(Overrides CMFCRibbonButton::OnDraw.)
CMFCRibbonGallery::OnEnable	(Overrides CMFCRibbonBaseElement::OnEnable.)
CMFCRibbonGallery::OnRTLChanged	(Overrides CMFCRibbonBaseElement::OnRTLChanged.)
CMFCRibbonGallery::RedrawIcons	Redraws the gallery.
CMFCRibbonGallery::RemoveItemToolTips	Removes the tooltips from all items in the gallery.
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData	(Overrides CMFCRibbonButton::SetACCData.)
CMFCRibbonGallery::SetButtonMode	Specifies whether to display the ribbon gallery as a drop-down button or as a palette directly on the ribbon.
CMFCRibbonGallery::SetGroupName	Sets the name of a group.
CMFCRibbonGallery::SetIconsInRow	Defines the number of items per row in the gallery.
CMFCRibbonGallery::SetItemToolTip	Sets the tooltip text for an item in the gallery.
CMFCRibbonGallery::SetPalette	Attaches a palette to a ribbon gallery.
CMFCRibbonGallery::SetPaletteID	Defines the command ID that is sent in the WM_COMMAND message when a gallery item has been selected.

Protected Methods

Name	Description
CMFCRibbonGallery::OnDrawPaletteIcon	Called by the framework when a gallery icon is drawn.

Remarks

A gallery button behaves just like a regular menu button except that it displays a gallery when a user opens it. When you select an item in a gallery, the framework sends the WM_COMMAND message together with command ID of the button. When you handle the message, you should call CMFCRibbonGallery::GetLastSelectedItem to determine which item was selected from the gallery.

Example

The following example demonstrates how to use various methods in the CMFCRibbonGallery class to configure a CMFCRibbonGallery object. The example illustrates how to specify the number of items per row in the gallery, enable resizing of the menu panel, enable the side bar to the left of the pop-up menu, and display the ribbon gallery as a palette directly on the ribbon bar. This code snippet is part of the DrawClient Sample: MFC Ribbon-Based OLE Object Drawing Application.

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

Inheritance Hierarchy

CObject   CMFCRibbonBaseElement      CMFCRibbonButton

         CMFCRibbonGallery

Requirements

Header: afxRibbonPaletteGallery.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CMFCRibbonButton Class

CMFCRibbonGalleryMenuButton Class

Other Resources

Classes (MFC Feature Pack)