BarManager.Controller Property

Gets or sets the Bar and Docking Controllers (Customizing Default View and Behavior Settings) that will provide default appearance and customization options for the bars belonging to the current BarManager.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v18.2.dll

Declaration

C#

[DefaultValue(null)]
[DXCategory("Appearance")]
public virtual BarAndDockingController Controller { get; set; }

VB.NET

<DefaultValue(Nothing)>
<DXCategory("Appearance")>
Public Overridable Property Controller As BarAndDockingController

Property Value

Type	Default	Description
BarAndDockingController	*null*	A BarAndDockingController object providing appearance options.

Remarks

Use the Controller property to explicitly assign a BarAndDockingController to the current BarManager. The BarAndDockingController provides various appearance and style settings for the bars owned by the BarManager.

If this property specifies a null value, the Bar Manager uses the DefaultBarAndDockingController‘s settings. Otherwise, the appearance settings are fetched from the assigned BarAndDockingController. The actual controller currently used can be obtained by calling the BarManager.GetController method.

See Bar and Docking Controllers (Customizing Default View and Behavior Settings) for more information.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Controller property.

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-implement-the-customdraw-event-for-bar-items-e4327/CS/CustomBarAndDockingController/CustomBarPainter.cs#L18

CustomDrawLinkArgs args = new CustomDrawLinkArgs(info);
CustomBarAndDockingController controller = item.Bar.Manager.Controller as CustomBarAndDockingController;
if (controller != null) {

VB.NET

how-to-implement-the-customdraw-event-for-bar-items-e4327/VB/CustomBarAndDockingController/CustomBarPainter.vb#L20

Dim args As New CustomDrawLinkArgs(info)
Dim controller As CustomBarAndDockingController = TryCast(item.Bar.Manager.Controller, CustomBarAndDockingController)
If controller IsNot Nothing Then