ThemePalette Class

A WPF Theme palette.

Assembly : DevExpress.Xpf.Core.v25.2.dll

Declaration

C#
VB.NET

csharp

public class ThemePalette :
    ThemePaletteBase

Public Class ThemePalette
    Inherits ThemePaletteBase

Remarks

Create and Customize a Palette

Create a palette instance and use the SetColor method to set color values to palette colors. The code snippet below changes the SelectionBackground and Foreground palette colors:

C#
VB.NET

csharp

var mypalette = new ThemePalette("CustomPalette");
mypalette.SetColor("SelectionBackground", Colors.Red);
mypalette.SetColor("Foreground", Colors.Black);

Dim mypalette = New ThemePalette("CustomPalette")
mypalette.SetColor(SelectionBackground, Colors.Red)
mypalette.SetColor(Foreground, Colors.Black)

Create a Theme with the Palette

To apply a dynamic palette to an application, you should create a new theme. This theme should be based on a Theme with a Palette. Specify the base theme and the dynamic palette name and use the CreateTheme method to create a new theme assembly.

C#
VB.NET

csharp

var customtheme = Theme.CreateTheme(mypalette, Theme.Office2016ColorfulSE);

Dim customtheme = Theme.CreateTheme(mypalette, Theme.Office2016ColorfulSE)

csharp

Theme.RegisterTheme(customtheme);
ApplicationThemeHelper.ApplicationThemeName = customtheme.Name;

Theme.RegisterTheme(customtheme)
ApplicationThemeHelper.ApplicationThemeName = customtheme.Name

Cache Palette Themes

You can cache the current palette theme’s assembly to reduce the theme loading time. The application uses the cached assemblies at the current and the following application runs.

Set the Theme.CachePaletteThemes to true to cache the current palette theme’s assembly. The following code sample enables the palette theme assemblies caching to a default directory and applies the Office2019Colorful theme with the RedWine predefined palette to the application:

C#
VB.NET

csharp

Theme.CachePaletteThemes = true;
Theme.RegisterPredefinedPaletteThemes();
ApplicationThemeHelper.ApplicationThemeName = "RedWineOffice2019Colorful";

Theme.CachePaletteThemes = true
Theme.RegisterPredefinedPaletteThemes()
ApplicationThemeHelper.ApplicationThemeName = "RedWineOffice2019Colorful"

Specify the Cache Location

Use the Theme.PaletteThemeCacheDirectory property to specify the directory where the cached assemblies are stored. The default cache directory is %LocalAppData%\DevExpress\PaletteThemeCache. The following code sample changes the default cache directory:

C#
VB.NET

csharp

Theme.PaletteThemeCacheDirectory = "C:\\DevExpress\\PaletteThemeCache";

Theme.PaletteThemeCacheDirectory = "C:\DevExpress\PaletteThemeCache"

Clear the Cache

To remove the directory with the cached assemblies, use the Theme.ClearPaletteThemeCache method:

C#
VB.NET

csharp

Theme.ClearPaletteThemeCache();

Theme.ClearPaletteThemeCache()

Inheritance

Object ThemePaletteBase ThemePalette Win10Palette