InRibbonGallery Class

An In-Ribbon gallery.

Namespace: DevExpress.XtraBars.Ribbon.Gallery

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

public class InRibbonGallery :
    BaseGallery,
    IImageCollectionHelper
Public Class InRibbonGallery
    Inherits BaseGallery
    Implements IImageCollectionHelper

Related API Members

The following members accept/return InRibbonGallery objects:

Remarks

A RibbonGalleryBarItem object is designed to display a gallery within a RibbonControl. The In-Ribbon gallery is represented by an InRibbonGallery class instance and can be accessed via the RibbonGalleryBarItem.Gallery property.

To add groups to the gallery, use the BaseGallery.Groups collection. Each element in this collection represents a GalleryItemGroup object and can possess and display multiple gallery items (images).

An In-Ribbon gallery provides the Dropdown button, and clicking on it expands the gallery (displays it as a popup window). By default, clicking this button opens a Dropdown gallery, which displays the contents of the In-Ribbon gallery.

Gallery items can be checked and unchecked. This feature is controlled by the BaseGallery.ItemCheckMode property. By default, changing the check states of items in the Dropdown gallery does not affect the check states of items in the In-Ribbon Gallery. To enable check state synchronization, set the InDropDownGallery.SynchWithInRibbonGallery property to true. You can access and enable this property via the InRibbonGallery.InitDropDownGallery event's e.PopupGallery.SynchWithInRibbonGallery parameter.

If a GalleryDropDown control is associated with the In-Ribbon gallery, a click on the Dropdown button displays this GalleryDropDown control.
This feature allows you to implement a different view (for instance, an expanded view) of an In-Ribbon gallery that will be displayed as a popup window. To bind a GalleryDropDown control to an In-Ribbon gallery, use the RibbonGalleryBarItem.GalleryDropDown property.

For more information see Galleries.

See Also