Skip to main content
Bar

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BarItemLink.UserPaintStyle Property

Gets or sets the link’s paint style defined by a user.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[Browsable(false)]
[XtraSerializableProperty]
public BarItemPaintStyle UserPaintStyle { get; set; }

#Property Value

Type Description
BarItemPaintStyle

A BarItemPaintStyle enumerator value specifying the link’s paint style defined by a user.

Available values:

Name Description
Standard

Specifies that a specific item is represented using its default settings.

PaintStyle.Standard

Caption

Specifies that a specific item is represented by its caption only.

PaintStyle.Caption

CaptionInMenu

Specifies that a specific item is represented by its caption when it is in a submenu, or by its image when it is in a bar.

PaintStyle.CaptionInmenu

CaptionGlyph

Specifies that a specific item is represented both by its caption and the glyph image.

PaintStyle.CaptionGlyoh

#Remarks

The link’s paint style can be specified by the corresponding item’s BarItem.PaintStyle property or by the link’s UserPaintStyle property. The latter gives you the capability to specify the link’s unique paint style. This allows you to provide several links to the same item but with different styles. The link’s BarLinkUserDefines.PaintStyle option determines which of these properties specifies the link’s paint style. Thus, if this option is enabled, the paint style is specified by the link’s UserPaintStyle property, otherwise, by the corresponding item’s BarItem.PaintStyle property.

Options that specify which link settings are determined by a user can be accessed using the BarItemLink.UserDefine property. Note that individual options can be enabled/disabled only in code. To disable all user defined options, call the BarItemLink.Reset method.

See Also