[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
     MDI Merging
    [Expand]Bar Manager Designer
    [Collapse]Runtime Customization and Layout Management
      Runtime Customization
      How To: Organize Bar Items into Categories
      Saving and Restoring a Bars Layout Automatically
      Saving and Restoring a Bars Layout Manually
      Layout Options and Customization Events
      Specifics of Bars Layout Calculation
    [Expand]Appearance and Hotkeys
   [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

This document explains what layout customization actions your end-users can perform and how, and what options you have to regulate these modifications.

Expanded Add and Customize Toolbars

End-users can add new toolbars and customize existing ones only by using the Customization Window dialog. To invoke this dialog, a user must do one of the following.

  • Right-click a toolbar and select "Customize...".

  • Click a toolbar's Quick Customization button and select "Add or Remove Buttons | Customize...".

In the "Toolbars" tab of the Customization Window, end-users can click corresponding buttons to create, rename, delete and reset toolbars. Check boxes next to toolbar names to specify these toolbars' visibility.

To prevent end-users from making these changes to a layout of toolbars, use the following API.




Gets or sets whether or not end-users can invoke the Customization Window dialog.


Utilize this property to disable context menus shown on right-clicking toolbars.



Disable these properties to hide Quick Customization buttons for all toolbars owned by this Bar Manager, or for specific toolbars only.


Specifies whether or not end-users can permanently remove this toolbar. By default, this option is enabled only for toolbars created by users at runtime.


Gets or sets whether or not end-users can rename this toolbar.

Expanded Drag-and-Drop Toolbars

By default, all toolbars except for a status bar display a drag border.

End-users can drag these borders to re-arrange toolbars, dock them to screen edges and make them floating.

The following API manages the availability of drag-and-drop features.

Property Description
BarOptions.DrawDragBorder If this property is disabled, a bar will not show its drag border and as a result, end-users will be unable to drag this toolbar.
Bar.CanDockStyle Enumerates all possible positions a toolbar can occupy. End-users are unable to dock this toolbar to other locations.
BarManager.AllowMoveBarOnToolbar If this property is disabled, end-users will be unable to move toolbars along their parent BarDockControl containers. All toolbars that do not occupy the entire row (see the BarOptions.UseWholeRow property) will stick together in a solid line without gaps.

Expanded Modify Link Layout

End-users can perform the following link operations at runtime.

  • Hide existing bar item links and show them again using the Quick Customization button.
  • Drag items from the "Commands" tab of the Customization Window dialog to toolbars, sub-menus and popup menus. By doing so, end-users create links to these bar items. For end-users' convenience, you can organize bar item into categories.
  • Drag item links away from toolbars and menus. To be able to drag a link, an end-user must either hold the ALT key, or have the Customization Window dialog opened. If a user drops a link outside toolbars and sub-menus, the link is removed, otherwise - moved to this new location. A user can also hold the CTRL key to copy this link to a desired position.
  • Right-click a link to be able to modify its caption and display settings. Link context menus are available only while the Customization Window dialog is active.

To disable required drag-and-drop features, utilize the following API.

Property Description
BarManager.AllowShowToolbarsPopup This property allows you to disable toolbar context menus.
BarOptions.DisableCustomization Prevents end-users from dragging links to/from this toolbar.
BarItem.ShowInCustomizationForm If this property is disabled, end-users will not see this item within the Customization Window dialog.

Expanded Change Global Toolbar Settings

The "Options" tab of the Customization Window dialog allows end-users to modify global behavior and appearance settings, common to all toolbars and item links.

Setting Description
Always show full menus Disables Recently Used Items if checked.
Show full menus after a short delay If this option is enabled, non-Recently Used Items are shown after a certain delay. Otherwise, a user has to click the menu expand button to view all menu items.
Reset my usage data A menu with Recently Used Items automatically updates its MRU list to start displaying menu entries requested by end-users. Clicking this button restores the original MRU list of all menus.
Large icons If checked, bar items display 32x32 pixel images.
Show ScreenTips on toolbars If checked, bar item links display hints.
Show shortcut keys in ScreenTips If checked, hints also display shortcuts assigned to bar item links.
Menu Animations Allows you to select the animation effect for expanding and collapsing sub-menus and popup menus.

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