Skip to main content

TileBarDropDownOptions.BackColorMode Property

Gets or sets how the TileBarItem.DropDownControl‘s background color is specified.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v22.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(BackColorMode.Default)]
public BackColorMode BackColorMode { get; set; }

Property Value

Type Default Description
BackColorMode Default

A value that defines how the TileBarItem.DropDownControl‘s background color is specified.

Available values:

Name Description
Default

The background of the TileBarItem.DropDownControl is not affected and painted as specified by the dropdown control’s Appearance property.

UseTileBackColor

The background of the TileBarItem.DropDownControl is painted using the tile’s background color. You can customize the tile’s background color using the TileBarItem.AppearanceItem.Normal.BackColor property.

UseBeakColor

The background of the TileBarItem.DropDownControl is painted using the TileBarDropDownOptions.BeakColor.

Property Paths

You can access this nested property as listed below:

Object Type Path to BackColorMode
TileBar
.DropDownOptions.BackColorMode
TileBarItem
.DropDownOptions.BackColorMode

Remarks

By default, the background of the control assigned to the TileBarItem.DropDownControl is not affected, and it is painted as specified by the control’s BackColor property.

You can paint the background of the dropdown control using the tile’s back color. To do this, set the BackColorMode property to BackColorMode.UseTileBackColor. By default, tiles are painted using the color specified by the current paint theme (skin). You can provide a custom back color for tiles using the TileBarItem.AppearanceItem.Normal.BackColor property. In the UseTileBackColor mode, if a tile is painted using a gradient fill, only the first color of the gradient fill is applied to the dropdown control’s background. To paint the dropdown control’s background using a gradient fill, set the BackColorMode property to Default and customize the Appearance property of the TileBarItem.DropDownControl as required.

To paint a beak using a custom color, set the TileBarDropDownOptions.BeakColor property. To paint the dropdown control’s background using the same color, set the BackColorMode property to BackColorMode.UseBeakColor.

See Also