Bar

BarAndDockingController.PaintStyleName Property

Gets or sets the name of the paint scheme applied to the Bars UI (BarManager), dock panels (DockManager) and MDI tabbed windows (XtraTabbedMdiManager).

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[DefaultValue("Default")]
[DXCategory("Appearance")]
public virtual string PaintStyleName { get; set; }
<DefaultValue("Default")>
<DXCategory("Appearance")>
Public Overridable Property PaintStyleName As String

Property Value

Type Default Description
String

"Default"

A string specifying the paint scheme name.

Remarks

Use the PaintStyleName property to specify the paint scheme for the Bars UI (BarManager), dock panels (DockManager) and MDI tabbed windows (XtraTabbedMdiManager). The paint scheme affects the overall UI appearance (borders, inner elements and in-place editors).

See the following table for paint scheme examples.

Value

Description

Image

"Default"

The paint scheme is determined by the BarAndDockingController.LookAndFeel object's settings.

"OfficeXP"

MS Office XP - inspired paint scheme.

Bars3_PaintStyle_OfficeXP

"Office2000"

MS Office 2000 - inspired paint scheme.

Bars3_PaintStyle_Office2000

"WindowsXP"

The paint scheme is dependent on the current Windows OS theme.

Bars3_PaintStyle_WindowsXP

"Office2003"

MS Office 2003 - inspired paint scheme.

Bars3_PaintStyle_Office2003

"Skin"

The skinning paint scheme, specified by UserLookAndFeel.SkinName property, is applied.

You can access the UserLookAndFeel.SkinName property to specify the skinning paint scheme in a number of ways:

  • For all controls within all forms in your application - via the DefaultLookAndFeel component or the UserLookAndFeel.Default static object.
  • For all XtraBars controls within all forms in your application - via the DefaultBarAndDockingController component or the BarAndDockingController.Default static object.

    Note that the BarAndDockingController.LookAndFeel.UseDefaultLookAndFeel property must be set to false for the Default BarAndDockingController's settings to be in effect.

  • For all XtraBars controls within a single form - via the BarAndDockingController component.

    Note that the BarAndDockingController.LookAndFeel.UseDefaultLookAndFeel property must be set to false for the BarAndDockingController's settings to be in effect.

Bars3_PaintStyle_Skin

If the string assigned to the PaintStyleName property doesn't match any of the strings listed above, the "Default" string will be assigned instead.

By default, inplace editors embedded in BarEditItem items are painted using the style settings defined by the PaintStyleName property. To change the default behavior, customize the RepositoryItem.LookAndFeel property of the BarEditItem.Edit objects.

See Also