Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[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
      Bar and Ribbon Glyph Skinning
      How to: Populate a Menu and Ribbon Gallery with DevExpress Skin Items and Localize Them
    [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]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]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Bar and Docking Controllers

Bar And Docking Controllers provide the default display and customization settings for the controls and components included in the XtraBars library.

Expanded List of XtraBars Settings

The display and customization settings provided by Bar And Docking Controllers include:

 

There are two types of Bar And Docking Controllers, which allow you to specify the application-scope and form-scope settings, respectively, for the XtraBars controls/components.

Expanded Default BarAndDockingController - Customizing the Default XtraBars Settings for all Forms

The Default BarAndDockingController provides the easiest way to customize the default settings for the XtraBars controls in the entire application. This controller can be accessed with the DefaultBarAndDockingController component.

Customizing settings of this controller affects the XtraBars controls that you're using within all forms in your application. Place this component onto the main form and customize its settings, as required.

At runtime, you can also use the BarAndDockingController.Default property to obtain the Default BarAndDockingController.

Expanded BarAndDockingController - Customizing the Default XtraBars Settings for Individual Forms

To specify the default settings for the XtraBars controls/components within a single form, do the following.

  1. Add a BarAndDockingController component to the form.
  2. 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

How would you rate this topic?​​​​​​​