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.v20.1.dll

Declaration

public static BackgroundSkinningMode BackgroundSkinningMode { get; set; }
Public Shared Property BackgroundSkinningMode As BackgroundSkinningMode

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.

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.
See Also