Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Bars
   [Collapse]Ribbon
    [Expand]The Ribbon UI
    [Expand]Visual Elements
    [Expand]Items and Item Links
     Ribbon Styles
    [Collapse]Galleries
      In-Ribbon Galleries
      Dropdown Galleries
    [Expand]Main Menus
    [Expand]Ribbon Control Designer
    [Expand]Runtime Capabilities
    [Expand]Miscellaneous
     Known Issues
   [Expand]Popup Menus
    Radial Menu
   [Expand]Common Features
   [Expand]Examples
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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

How would you rate this topic?​​​​​​​