windowsforms-devexpress-dot-xtraeditors-dot-windowsformssettings-c0a8530a.md
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.v25.2.dll
NuGet Packages : DevExpress.Utils, DevExpress.Wpf.Core
public static BackgroundSkinningMode BackgroundSkinningMode { get; set; }
Public Shared Property BackgroundSkinningMode As BackgroundSkinningMode
| Type | Description |
|---|---|
| DevExpress.XtraEditors.BackgroundSkinningMode |
A DevExpress.XtraEditors.BackgroundSkinningMode object enumerator value that specifies what appearance colors can blend with skin element bitmaps.
|
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.
| Control | UI Element | Appearance Property | Appearance Setting |
|---|---|---|---|
| Data Grid | Column Header | AppearanceHeader | BackColor |
| Data Grid | Band Header | AppearanceHeader | BackColor |
| Data Grid | Layout View Card Caption | Appearance.CardCaption | BorderColor |
| Data Grid | Layout View Focused Card Caption | Appearance.FocusedCardCaption | BorderColor |
| Data Grid | Layout View Selected Card Caption | Appearance.SelectedCardCaption | BorderColor |
| Data Grid | Layout View Hide Selection Card Caption | Appearance.HideSelectionCardCaption | BorderColor |
| TreeList | Column Header | AppearanceHeader | BackColor |
| TreeList | Band Header | AppearanceHeader | BackColor |
| Pivot Grid | Field Header | Appearance.Header | BackColor |
| Ribbon | Bar Button Items displayed within Page Headers | BarButtonItem.ItemAppearance.Normal | BackColor |
| Dock Manager | Dock Panel | Appearance | BorderColor |
| Application UI Manager | Tabbed View Document Header | Appearance.Header | BackColor |
| Application UI Manager | Widget View Document Caption | AppearanceCaption | BackColor |
| Application UI Manager | Widget View Document Active Caption | AppearanceActiveCaption | BackColor |
| Application UI Manager | Native MDI View Document Caption | AppearanceCaption | BackColor |
| Application UI Manager | Native MDI View Document Active Caption | AppearanceActiveCaption | BackColor |
| Tab Pane | Tab Navigation Page Caption | TabNavigationPage.Properties.AppearanceCaption | BackColor |
| Navigation Pane | Navigation Page Caption | NavigationPage.Properties.AppearanceCaption | BackColor |
| Group Control | Caption | AppearanceCaption | BorderColor |
| Tab Control | Tab Page Header | XtraTabPage.Appearance.Header | BackColor |
| Layout Control | Group | LayoutControlGroup.AppearanceGroup | BorderColor |
| Layout Control | Tab Page Header | LayoutControlGroup.AppearanceTabPage.Header | BackColor |
| SimpleButton | Button | SimpleButton.Appearance | BackColor |
| TextEdit-based Controls (WXI Skin only) | Edit Box | TextEdit.Properties.Appearance | BackColor |
| MemoEdit | Edit Box | MemoEdit.Properties.Appearance | 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;
'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).
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.
See Also