[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Collapse]Ribbon, Bars and Menu
   [Expand]Common Features
    [Expand]Getting Started
    [Expand]Bar Layout
    [Expand]Populating Bars
     Bar Actions
    [Collapse]Runtime Customization
      Quick Customization
      Customization Window
     Saving and Restoring a Bar Layout
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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)

Customization Window

Expanded Overview

The customization window is an alternative to Quick Customization that gives an end-user complete control over the toolbar's content and appearance.

To open the customization window, an end-user should select Customize... from the customization menu.

The customization menu appears when an end-user right-clicks a bar.

The following table lists properties that control the availability of the customization menu for different bar elements.

Property Description
BarManager.AllowCustomization Specifies whether the customization menu is enabled for the current BarManager.
Bar.AllowCustomizationMenu Specifies whether the customization menu is enabled for the current Bar.
ToolBarControlBase.AllowCustomizationMenu Specifies whether the customization menu is enabled for the current ToolBarControlBase descendant.

Expanded Adding and Removing Toolbars

The customization window's Toolbars tab allows an end-user to manipulate entire toolbars.

The following image demonstrates the Toolbars tab.

Check boxes displayed to the left of the toolbar names toggle the toolbar visibility.

To add a bar, click New. To delete a bar, select it in the Toolbars list and click Delete. The Rename button allows you to rename a bar.

Expanded Adding and Removing Bar Items

The customization window's Commands tab allows end-users to add, remove and copy individual bar items.

To add a specific command to a bar, search for this command in the customization window's Commands page and drag the command to a bar.


To learn more about bar item categories, see Categories topic.

Expanded Customizing Individual Bar Items

While the customization window is open, end-users can perform the following actions.

  • Change a bar item's position

    Drag a bar item to the required position.

  • Copy a bar item

    Hold CTRL and drag a bar item to the required position.

  • Remove an item from the toolbar

    Drag a bar item outside the toolbar.

  • Open the item customization menu

    Right-click a bar item.

The following image demonstrates the item customization menu.

The following table lists the customizations available from the item customization menu.

Menu Item Description
Reset Resets the command's display style to default.
Delete Deletes the command from the bar.
Caption Allows you to modify the command's caption.
Display mode Allows you to modify the command's display style.
Glyph alignment Allows you to change the alignment of the item's glyph.
Glyph size Allows you to change the size of the item's glyph.
Visible Toggles the command's visibility.
Begin a group Specifies whether the item starts a visual group.

Expanded See Also

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