How to Create an in-Ribbon Gallery at Design Time

Dec 28, 2020

To quickly build a new gallery inside a Ribbon, first right-click the tab group header and select the “Add Group With Toolbar” menu item to add a new tab group with an empty toolbar to the Ribbon, as shown in the following image:

Then, perform the following steps:

To place a gallery in the toolbar, right-click the toolbar and select Add Item, and then the TdxRibbonGalleryItem in the context menu.

In the Object Inspector , click the ellipsis button next to the gallery’s GalleryCategories property to open the Ribbon gallery designer. In the designer window, click the Add Group toolbar button to create a gallery group. Provide it with header settings and appearance options, as required.

When a gallery group is selected, click the Add Item toolbar button in the designer window to create the gallery items that this group will contain. Provide each gallery item with a caption, description, and/or explanatory image.

Using a gallery’s OnGroupItemClick or a gallery item’s OnClick event, implement functionality common to all items or for each item individually.

Run the application to see the result.