[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Bars
   [Expand]Ribbon
   [Expand]Popup Menus
    Radial Menu
   [Collapse]Common Features
    [Collapse]Appearance and Look and Feel
      Look And Feel and Skinning
      Appearances
      Appearance Inheritance Options
      Alpha Blending and Background Images
      Bar and Docking Controllers (Customizing Default View and Behavior Settings)
      Bar and Ribbon Glyph Skinning
    [Expand]Galleries
     Stub Glyphs
     The List of Bar Items and Links
   [Expand]Examples
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap 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]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Bar and Docking Controllers (Customizing Default View and Behavior Settings)

Bar And Docking Controllers (DefaultBarAndDockingController and BarAndDockingController) allow you to customize the application-scope (global) and form-scope display and customization settings for the controls and components included in the XtraBars library:

Expanded List of XtraBars Settings

The Bar And Docking Controllers provide the following display and customization settings:

 

To learn how to customize the look-and-feel settings of the XtraBars controls, see Look And Feel and Skinning. The following sections show how you can customize other settings for all forms and individual forms.

Expanded Customizing the Default XtraBars Settings for all Forms (Default BarAndDockingController)

Place the DefaultBarAndDockingController component onto the main form to access the global settings shared by all XtraBars controls within all forms.

In code, use the BarAndDockingController.Default property to access and customize these settings.

Expanded Customizing the Default XtraBars Settings for Individual Forms (BarAndDockingController)

To specify the default settings for the XtraBars controls/components within a single form, add a BarAndDockingController component to the form.

Ensure that this controller is bound to the target DevExpress XtraBars controls, via their Controller properties.

By default, the Controller properties of the XtraBars controls and components are set to null, which means that the Default BarAndDockingController's settings are in effect for these controls. If you assign a BarAndDockingController object to this property, this controller will provide settings for the corresponding XtraBars control, instead of the Default BarAndDockingController.

When you place a BarAndDockingController component onto a form for the first time, it is automatically assigned to the Controller properties of existing XtraBars controls and components that reside on this form. From that point on, this controller will provide settings for these controls and components.

Expanded Example

Suppose you have two forms, each of which features a Bars UI implemented by a BarManager component.

If you want to provide identical settings for all the bars within the two forms, place the DefaultBarAndDockingController component onto the main form and customize its settings. The BarManager.Controller properties of the two BarManagers must be set to null.

If you need to provide independent bar settings for the two forms, do one of the following:

Expanded See Also

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