A bar item that represents an In-Ribbon gallery.
[SmartTagSupport(typeof(BarItemDesignTimeBoundsProvider), SmartTagSupportAttribute.SmartTagCreationMode.UseComponentDesigner)] public class RibbonGalleryBarItem : BarButtonItem
<SmartTagSupport(GetType(BarItemDesignTimeBoundsProvider), SmartTagSupportAttribute.SmartTagCreationMode.UseComponentDesigner)> Public Class RibbonGalleryBarItem Inherits BarButtonItem
Related API Members
The following members accept/return RibbonGalleryBarItem objects:
The RibbonGalleryBarItem object implements an In-Ribbon gallery for a RibbonControl.
To display an In-Ribbon gallery, do the following:
Create a RibbonGalleryBarItem object at design time via the Ribbon Control Designer's Gallery Page or in code using the class's constructor.
- Add the created bar item to a specific Ribbon page group (a RibbonPageGroup object).
- Customize the In-Ribbon gallery via the RibbonGalleryBarItem.Gallery property. This property represents an InRibbonGallery class instance. Use the RibbonGalleryBarItem.Gallery property to add gallery groups, gallery items to groups, etc.
- Optionally you can implement an extended version of the created In-Ribbon gallery that will be displayed as a popup window when the Dropdown button is clicked (see the image above). To do this, create and customize a GalleryDropDown control, which will represent the gallery's extended version, and then assign it to the RibbonGalleryBarItem.GalleryDropDown property.
See Galleries for more information.