CMFCRibbonGallery::AddSubItem

  • Article

Adds a new menu item to the drop-down menu.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1,
    BOOL bOnTop=FALSE 
);

Parameters

  • [in] pSubItem
    A pointer to the item to add to the menu.

  • [in] nIndex
    Specifies the zero-based index of a location where to insert the item.

  • [in] bOnTop
    TRUE to specify that the item should be inserted before the ribbon gallery; otherwise, FALSE.

Remarks

You can combine popup galleries with popup menu items by calling this method. Menu items can be placed before or after the gallery.

To insert the item before the gallery, set bOnTop to TRUE. Set bOnTop to FALSE to insert the item below the gallery.

Note

The parameter nIndex specifies the insertion index both at the top of the gallery and at the bottom of the gallery. For example, if you need to insert an item one position before the gallery, set nIndex to 1 and bOnTop to TRUE. Similarly, if you need to insert an item one position below the gallery, set nIndex to 1 and bOnTop to FALSE.

Requirements

Header: afxRibbonPaletteGallery.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CMFCRibbonGallery Class