Skip to main content

RibbonGalleryBarItem Class

A bar item that displays a gallery.

Namespace: DevExpress.Xpf.Ribbon

Assembly: DevExpress.Xpf.Ribbon.v14.2.dll

#Declaration

public class RibbonGalleryBarItem :
    BarItem,
    ILinksHolder,
    IMultipleElementRegistratorSupport,
    IBarNameScopeSupport,
    IInputElement,
    ILogicalChildrenContainer

#Remarks

Use RibbonGalleryBarItem objects to add galleries to the RibbonControl.

BarItemTypes_Gallery

To specify a gallery for the RibbonGalleryBarItem, use the RibbonGalleryBarItem.Gallery property. A gallery consists of gallery groups (GalleryItemGroup), each of which can display any number of gallery items (GalleryItem).

Optionally, you can implement an extended version of the created gallery that will be displayed as a popup window when the RibbonGalleryBarItem's Dropdown button is clicked. A dropdown gallery can be specified via the RibbonGalleryBarItem.DropDownGallery property.

By default, captions (GalleryItemGroup.Caption) of gallery groups are not visible for in-ribbon galleries. By default, the captions are visible for dropdown galleries.

#Examples

This example shows how to create an in-Ribbon gallery, represented by the RibbonGalleryBarItem class.

RibbonControl_Ex_Gallery

#Implements

See Also