UserLookAndFeel.SkinMaskColor Property

Gets or sets a custom hue applied to some skin elements.

Namespace: DevExpress.LookAndFeel

Assembly: DevExpress.Utils.v21.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Win.Design, DevExpress.Wpf.Core

Declaration

C#

[DXCategory("Appearance")]
public Color SkinMaskColor { get; set; }

VB.NET

<DXCategory("Appearance")>
Public Property SkinMaskColor As Color

Property Value

Type	Description
Color	A custom hue applied to skin elements.

Remarks

Use the SkinMaskColor and UserLookAndFeel.SkinMaskColor2 properties to alter the hue of skin elements. The UserLookAndFeel.SkinMaskColor2 is typically used to change the hue of control elements when they are highlighted/hovered, while the SkinMaskColor is typically applied in other cases. Whether color masking is in effect and which mask color is applied to which control element is determined by settings of the skin.

The algorithm used to alter colors of skin elements is similar to the Hue filter in Adobe Photoshop. The control elements will not get the exact colors specified by the SkinMaskColor and UserLookAndFeel.SkinMaskColor2 properties. Their colors will be altered to gain hues specified by these properties.

To allow an end-user to customize the skin hue, you can use the Color Mixer dialog. It can be opened as follows:

C#

using (DevExpress.XtraEditors.ColorWheel.ColorWheelForm f = new DevExpress.XtraEditors.ColorWheel.ColorWheelForm()) {
    f.ShowDialog(this);
}

VB.NET

Using f As New DevExpress.XtraEditors.ColorWheel.ColorWheelForm()
    f.ShowDialog(Me)
End Using

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SkinMaskColor property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-color-specific-buttonedits-buttons-by-taking-into-account-the-current-skin-t522495/CS/dxCustomButtonEdit/Form1.cs#L29

look.UseDefaultLookAndFeel = false;
look.SkinMaskColor = color;
repositoryItem.LookAndFeel.Assign(look);

how-to-override-the-default-skin-image-colorization-algorithm-t367920/CS/CustomColorizerTest/Program.cs#L22

UserLookAndFeel.Default.SetSkinStyle("Office 2016 Colorful");
UserLookAndFeel.Default.SkinMaskColor = Color.FromArgb(135, 35, 0);
SkinImageColorizer.Default = new MainThemeColorizer();

VB.NET

how-to-color-specific-buttonedits-buttons-by-taking-into-account-the-current-skin-t522495/VB/dxCustomButtonEdit/Form1.vb#L27

look.UseDefaultLookAndFeel = False
look.SkinMaskColor = color
repositoryItem.LookAndFeel.Assign(look)

how-to-override-the-default-skin-image-colorization-algorithm-t367920/VB/CustomColorizerTest/Program.vb#L26

UserLookAndFeel.Default.SetSkinStyle("Office 2016 Colorful")
UserLookAndFeel.Default.SkinMaskColor = Color.FromArgb(135, 35, 0)
SkinImageColorizer.Default = New MainThemeColorizer()