[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
    [Expand]Main Menus
    [Expand]Ribbon Control Designer
    [Collapse]Runtime Capabilities
      Ribbon Merging
      Key Tips
      Runtime Customization
      Touch Support
     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)

Runtime Customization

Expanded Overview

Users can customize commands in the ribbon via the Customizaton Form. To invoke the form, right-click the ribbon and select Customize Ribbon in the pop-up menu.

The Customization Form displays available items and the original layout on the left. On the right, the form displays the actual layout and items in the ribbon. Users can reorder, remove, and rename items in the ribbon, and create custom groups, tabs, etc.

How to Enable the Customization Form

Enable the RibbonControl.AllowCustomization option to allow users to invoke the Customization Form. To show the form in code, call the RibbonControl.ShowCustomizationForm method.

End-User Capabilities

Users can perform the following tasks via the Customization Form:



Add a new page

Click New and select New Tab in the drop-down menu.

Add a new group

Select a page on the right, click New and select New Group in the drop-down menu.

Hide a page or page group

Select a page or page group on the right and click the left arrow button.

Rename a page or page group

Select a page or page group on the right and click Rename.

Add a command to a custom group (users cannot add commands to original groups)

  • Select a command on the left and a custom group on the right. Click the right arrow button.

  • Drag a command on the left to a custom group on the right.

Re-arrange pages and groups

  • Select a page or group. Use the up and down arrow buttons to change its position.

  • Drag a page or group to a new position.

Import or export a custom layout

Click Import/Export and select an option in the drop-down menu: import or export the layout.

Restore the original layout

Click Reset and select an option in the drop-down menu: reset the selected page or the entire ribbon. In the latter case, the layout is restored instantly. For more information, see RibbonControl.SetCurrentLayoutAsDefault.

Expanded Options

The RibbonControl.OptionsCustomizationForm property provides access to settings that affect the form's appearance and behavior:

Auto-Save Layout

The ribbon can automatically save the layout to an XML file when the form closes. The layout will be automatically restored at the next application startup.

Enable the RibbonControl.AutoSaveLayoutToXml option to save the layout to an XML file when the user closes the form. The RibbonControl.AutoSaveLayoutToXmlPath property specifies the file's location.

Expanded How to Customize the Form

The RibbonControl.CustomizationFormShowing event fires when the form is about to be displayed and allows you to customize the form. The CustomizatoinForm event argument provides access to a RibbonCustomizationForm object that specifies the form.

The code below shows how to change the form's caption.

The code below shows how to customize the form's buttons.

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