[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Collapse]Ribbon, Bars and Menu
    [Expand]The Ribbon UI
    [Expand]Visual Elements
    [Expand]Items and Item Links
     Ribbon Styles
      In-Ribbon Galleries
      Dropdown Galleries
    [Expand]Main Menus
    [Expand]Ribbon Control Designer
    [Expand]Runtime Capabilities
     Known Issues
   [Expand]Popup Menus
    Radial Menu
   [Expand]Common Features
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

In-Ribbon Galleries

An In-Ribbon gallery displays a list of images within a RibbonControl.

It can be created by adding a RibbonGalleryBarItem object to the RibbonPageGroup.ItemLinks collection. The RibbonGalleryBarItem.Gallery object (of the InRibbonGallery type, a BaseGallery descendant) refers the gallery itself and provides multiple customization options. For an example of creating a gallery at design time and runtime, see the following tutorial.

Ribbon Control is one of the DevExpress controls that provide the gallery functionality. General information on galleries, items and common gallery features can be found in the following topics:

Structurally, a gallery consists of gallery items (GalleryItem) combined into gallery groups (GalleryItemGroup). Gallery groups and items have captions, which can be hidden if required. This layout is demonstrated in the image above, where the gallery only displays images.

Gallery items provide options that specify an item's image, hover image, hint, caption, description, checked state, etc. The gallery object contains options that specify the layout and behavior of gallery items (e.g., item checking availability, image size, distance between items, column count, etc.)

To respond to clicking and double-clicking a gallery item, handle the BaseGallery.ItemClick and BaseGallery.ItemDoubleClick event, respectively.

If the item checking feature is enabled, handle the BaseGallery.ItemCheckedChanged event to perform actions on item selection/deselection.

See the Gallery Controls and Gallery Items topics to learn more.

Expanded Expanding an In-Ribbon Gallery

An In-Ribbon gallery contains a Dropdown button. A click on this button invokes an automatically generated or custom gallery popup window (GalleryDropDown control).

See Dropdown Galleries for more information on these galleries and their customizations.

Expanded See Also

Is this topic helpful?​​​​​​​