Skip to main content

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

TileBarDropDownOptions.BackColorMode Property

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

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v24.2.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