WindowsFormsSettings.BackgroundSkinningMode Property
Gets or sets what colors assigned to AppearanceObject.BackColor or AppearanceObject.BorderColor properties can blend with skin element bitmaps.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.Utils.v18.2.dll
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 versions prior to 18.2, background and/or border colors for the elements in the list below were inactive if these elements used skins. In this case, elements’ surfaces would be covered by skin elements’ bitmaps, and changing Appearance settings produced no visual results.
- 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 these older versions, you had to disable element skins to highlight these elements with a custom color. Starting with version 18.2, you can apply custom Appearance colors without the necessity to disable skins - your custom colors will be used to colorize skin elements.
//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.
- AllColors - the updated v18.2 behavior: custom Appearance colors affect UI elements regardless of their LookAndFeel skin settings.
Legacy - the older behavior seen in v18.1 and earlier: custom Appearance colors affect only those UI elements that do not use skins.
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.