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.v24.1.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.
| 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;
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.