WindowsFormsSettings.BackgroundSkinningMode Property
Gets or sets whether colors assigned to AppearanceObject.BackColor or AppearanceObject.BorderColor properties can blend with skin element bitmaps.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.Utils.v20.2.dll
NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core
Declaration
Property Value
| Type | Description |
|---|---|
| DevExpress.XtraEditors.BackgroundSkinningMode | A DevExpress.XtraEditors.BackgroundSkinningMode object enumerator value that specifies what appearance colors can blend with skin element bitmaps. |
Remarks
In version 18.2 and higher, you can change the background and/or border colors of the following elements without the necessity to disable skins — your custom colors will be used to colorize skin elements.
- GridColumn and GridBand headers (BackColor)
- TreeListColumn and TreeListBand headers (BackColor)
- PivotGridControl columns headers (BackColor)
- LayoutView card captions (BorderColor)
- tab headers and captions for Application UI Manager documents and Dock Manager panels (BorderColor)
- NavigationPane tabs (BorderColor)
- GroupControl (BorderColor)
- LayoutControl group headers (BorderColor)
- SimpleButton (BackColor)
In versions prior to 18.2, you were not able to change the background and/or border colors for these elements in skin paint themes. You had to disable element skins to highlight these elements with a custom color.
//v18.2 and newer
simpleButton1.Appearance.BackColor = System.Drawing.Color.DarkOrange;
//v18.1 and older
simpleButton1.LookAndFeel.UseDefaultLookAndFeel = false;
simpleButton1.LookAndFeel.Style = DevExpress.LookAndFeel.LookAndFeelStyle.Flat;
simpleButton1.Appearance.BackColor = Color.DarkOrange;
The BackgroundSkinningMode property allows you to restore the behavior seen in versions 18.1 and earlier. The following options are available:
- AllColors - custom Appearance colors affect UI elements in all paint themes.
Legacy - custom Appearance colors affect only those UI elements that do not use skins (the behavior seen in v18.1 and earlier).
Tip
If you want to restore the older behavior to disable custom Appearance settings in your project that were inactive before the v18.2 update, we recommend that you use the service WindowsFormsSettings.ForcePaintApiDiagnostics method to find and remove these junk settings instead.
- Default - equal to Legacy if the WindowsFormsSettings.DefaultSettingsCompatibilityMode property is set to v18_1 or less; otherwise, equal to AllColors.
- DXColors - UI elements blend only DX Skin Colors with skin element bitmaps. Other custom colors are not in effect.