BarAndDockingController Class

Allows you to customize the form-scope display and behavior settings for controls and components included in the XtraBars library - bars, dock panels, Ribbon controls, App UI Manager (DocumentManager) and tabbed windows (XtraTabbedMdiManager).

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v18.1.dll

Declaration

C#

[ToolboxBitmap(typeof(ToolboxIconsRootNS), "BarAndDockingController")]
[TypeConverter("DevExpress.XtraBars.TypeConverters.BarAndDockingControllerTypeConverter, DevExpress.XtraBars.v18.1.Design")]
[ToolboxTabName("DX.18.1: Navigation & Layout")]
public class BarAndDockingController :
    Component,
    ISupportInitialize,
    IAppearanceOwner

VB.NET

<ToolboxBitmap(GetType(ToolboxIconsRootNS), "BarAndDockingController")>
<TypeConverter("DevExpress.XtraBars.TypeConverters.BarAndDockingControllerTypeConverter, DevExpress.XtraBars.v18.1.Design")>
<ToolboxTabName("DX.18.1: Navigation & Layout")>
Public Class BarAndDockingController
    Inherits Component
    Implements ISupportInitialize,
               IAppearanceOwner

Related API Members

The following members accept/return BarAndDockingController objects:

Show 17 links

Library	Related API Members
WinForms Controls	BackstageViewControl.Controller
	BackstageViewControl.GetController()
	BarAndDockingController.Default
	BarAndDockingController.GetDefaultController(Control, IBarAndDockingControllerClient)
	BarManager.Controller
	BarManager.GetController()
	BarManagerAppearances.Controller
	DefaultBarAndDockingController.Controller
	DockManager.Controller
	DockManagerAppearances.Controller
	DocumentManager.BarAndDockingController
	GalleryControl.Controller
	GalleryControl.GetController()
	RibbonControl.Controller
	RibbonControl.GetController()
	XtraTabbedMdiManager.Controller
Reporting	XRDesignMdiController.Controller

Remarks

The BarAndDockingController class is designed to store the LookAndFeel, appearance and customization settings for the controls and components included in the XtraBars library:

• Bars UI (BarManager)
• Ribbon UI (RibbonControl, RibbonForm, RibbonStatusBar, BackstageViewControl, ApplicationMenu)
• Dock panels (DockManager)
• Application UI (Windows UI, Widget UI, Tabbed UI, Native MDI) implemented with the DocumentManager component
• Tabbed MDI windows (XtraTabbedMdiManager)

See the following topics to learn more:

• Bar and Docking Controllers (Customizing Default View and Behavior Settings)
• Look And Feel and Skinning
• Appearances

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BarAndDockingController class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-barmanager-baranddockingcontroller-and-related-class-descendants-e1572/CS/MyBarManager/MyBarAndDockingController.cs#L6

namespace WindowsApplication1 {
    public class MyBarAndDockingController : BarAndDockingController {
        public MyBarAndDockingController(IContainer container) : base() { }

how-to-handle-a-double-click-on-a-tab-when-the-xtratabbedmdimanager-component-is-used-e891/CS/Form1.cs#L62

internal DevExpress.XtraBars.BarMdiChildrenListItem barMdiChildrenListItem1;
internal DevExpress.XtraBars.BarAndDockingController barAndDockingController1;
internal DevExpress.XtraEditors.Repository.RepositoryItemImageComboBox repositoryItemImageComboBox1;

how-to-create-a-custom-bar-item-with-a-transparent-background-e2460/CS/CustomBarTransparentButton/BarTransparentButtonItem.cs#L33

public static void Register() {
    Register(BarAndDockingController.Default);
}

how-to-create-a-table-bar-item-for-ribboncontrol-e4491/CS/testSample/TableBarItem/CustomController/MyBarAndDockingController.cs#L18

{
    public class MyBarAndDockingController : BarAndDockingController
    {

a-custom-toolbar-button-with-checked-and-dropdown-styles-e2266/CS/BarCheckAndDropDownButton.cs#L66

public static void RegisterCustomItems() {
    BarManagerPaintStyleCollection styles = BarAndDockingController.Default.PaintStyles;
    BarManagerPaintStyle style = styles["Skin"];

VB.NET

how-to-create-barmanager-baranddockingcontroller-and-related-class-descendants-e1572/VB/MyBarManager/MyBarAndDockingController.vb#L8

Public Class MyBarAndDockingController
    Inherits BarAndDockingController
    Public Sub New(ByVal container As IContainer)

how-to-handle-a-double-click-on-a-tab-when-the-xtratabbedmdimanager-component-is-used-e891/VB/Form1.vb#L58

Friend barMdiChildrenListItem1 As DevExpress.XtraBars.BarMdiChildrenListItem
Friend barAndDockingController1 As DevExpress.XtraBars.BarAndDockingController
Friend repositoryItemImageComboBox1 As DevExpress.XtraEditors.Repository.RepositoryItemImageComboBox

how-to-create-a-custom-bar-item-with-a-transparent-background-e2460/VB/CustomBarTransparentButton/BarTransparentButtonItem.vb#L37

Public Shared Sub Register()
    Register(BarAndDockingController.Default)
End Sub

how-to-create-a-table-bar-item-for-ribboncontrol-e4491/VB/testSample/TableBarItem/CustomController/MyBarAndDockingController.vb#L18

Public Class MyBarAndDockingController
    Inherits BarAndDockingController

a-custom-toolbar-button-with-checked-and-dropdown-styles-e2266/VB/BarCheckAndDropDownButton.vb#L77

Public Shared Sub RegisterCustomItems()
    Dim styles As BarManagerPaintStyleCollection = BarAndDockingController.Default.PaintStyles
    Dim style As BarManagerPaintStyle = styles("Skin")

Inheritance

Object

MarshalByRefObject

Component

BarAndDockingController