RibbonBar WinForms Control

Create innovative user interfaces and build Office 2007 and 2010 ribbon bar design

Home > WinForms UI Controls > User Manual > Create Gallery in RibbonBar in C#

Create a Gallery using KetticGalleryElement in C#.NET

KetticRibbonBar control for Windows Forms provides a KetticGalleryElement for the users to select visual items. The default setting of the gallery displays a single row of gallery item and up and down rows for the users to scroll to other row items. To create a gallery, we need to choose a KetticRibbonBar group, open the smart tag and select the Edit Items option to pop up the Collection Editor of KetticItem. Hit the arrow of the Add button and choose the KetticGalleryItem option. After these changes, the gallery will display in the Ribbon group.

Gallery Element Properties of RibbonBar Control

MaxColumns, this property determines the maximum number of columns displayed in the collapsed view of gallery.
MaxRows, this property determines the maximum number of rows displayed in the collapsed view of gallery
MaxDropDownColumns, this property determines the maximum number of columns displayed in the drop down of gallery
MinDropDownColumns, this property determines the minimum number of columns shown in the drop down of gallery

Add Items to KetticGalleryElement in RibbonBar

The KetticGalleryElement allows the users to add items to the gallery at design-time. The steps below demonstrate how to add an item into gallery of RibbonBar.

After create the gallery in your KetticRibbonForm project, select the KetticGalleryElement control.
Find the Items property in Properties window of the gallery, click the ellipsis button.
In the Collection Editor of the KetticElement, expand the drop down arrow of the Add button and a KetticGalleryItem will display
Customize the text and image properties for the gallery item and then click the OK button to save the changes. A gallery item has been created.

C# code for Adding Items to Gallery of RibbonBar

KetticRibbonBar control contains C# API for adding items to gallery at runtime. The following C# code demonstrates how to add items to gallery of RibbonBar control for Windows Forms.

Add Groups to Gallery of RibbonBar Control

The KetticGalleryElement allows the UI designers to add groups to the gallery at design-time. The groups are used to divide the items into different sections and will display in the gallery group when a group of items under the same title. The steps below demonstrate how to add a group into gallery of RibbonBar.

After create the gallery in your KetticRibbonForm project, select the KetticGalleryElement control.
Find the Groups property in Properties window of the gallery, and click the ellipsis button.
In the Collection Editor of the KetticElement, expand the drop down arrow of the Add button and a KetticGalleryGroupItem will display
Customize the text and Item properties for the gallery group item
In the Items Collection Editors, select the KetticGalleryItems that will be added to the gallery group
Click the OK button to save the changes. A gallery group has been added.

C# Add Groups to Gallery of KetticRibbonBar

KetticRibbonBar control allows the designers to add items to gallery using C# code at runtime to build user interface of RibbonBar. The following C# code demonstrates how to add items to gallery of RibbonBar control.

Create Filtering for Gallery of RibbonBar

KetticGalleryElement allows the users to create filtering for the gallery. The gallery filter actually is a set of groups and displays as options of a drop-down list. It helps the users to select the gallery group combination that will be shown in the popup. The steps below demonstrate how to gallery filters.

After creating the gallery in your KetticRibbonForm project, select the KetticGalleryElement control.
Find the Filters property in Properties window of the gallery, and click the ellipsis button.
In the Collection Editor of the KetticElement, expand the drop down arrow of the Add button and a new filter will display
Customize the text and Item properties for the gallery filters, and then click the ellipsis button
In the Items Collection Editors, select the KetticGalleryGroupItems that will be added to the gallery filter, and then click the ellipsis button.
Click the OK button to save the filter items. A gallery filter has been added.

C# Create Gallery Filters in KetticRibbonBar

KetticRibbonBar control allows the designers to create gallery filters using C# code at runtime to build user interface of RibbonBar. The following C# code demonstrates how to create gallery filters at run time.

Create Tools for KetticGallery in RibbonBar

KetticGalleryElement places the tools and items beneath the groups. They are not a part of the groups and will always be shown even if performing the gallery filtering. The following C# code demonstrates how to create a tool at design time.

Select the KetticGalleryElement control and find the Tools property in Properties window and click the ellipsis button.
In the Collection Editor of the KetticElement, expand the drop down arrow of the Add button and add an a new item, one of KetticMenuItem, KetticMenuButtonItem and KetticMenuComboItem
Customize the new tool and click OK button to save the modifications

C# Create Gallery Filters in KetticRibbonBar

KetticRibbonBar control allows the designers to create gallery tools using C# code at runtime to build user interface of RibbonBar. The following C# code demonstrates how to create tools for gallery at run time.


KetticMenuButtonItem buttonItem = new KetticMenuButtonItem("Click me!");
this.ketticGalleryElement1.Tools.Add(buttonItem);

UI Controlsfor Windows Forms

.NET WinForms UI Overview .NET WinForms UI Features .NET WinForms UI Guide C# WinForms UI Design VB.NET WinForms UI Design

WinForms UI Controls