DevExpress WPF控件調色板允許您將顏色（例如公司顏色）集成到WPF應用程序中并自定義主題中使用的顏色，在此實例中您可以創建自定義調色板或使用預定義調色板。

DevExpress WPF v21.1完整版下載

Palette是命名顏色的列表，每種顏色都有一個ColorName值和一個Color值，您可以使用ColorName將顏色分配給任意數量的UI元素：

注意：您可以使用 WPF 主題設計器來編輯調色板顏色或將其綁定到 UI 元素。

以下 DevExpress WPF 主題包含的調色板：

預定義的調色板

包括以下預定義的調色板：

在代碼中應用調色板

注意：當您切換主題時，應用程序不會卸載加載的主題程序集。

1. 在您的項目中引用 NuGet 包。

2. 調用 方法來啟用預定義的調色板。

3. 將 屬性設置為所需的預定義調色板名稱和基本主題名稱組合。

C#

Theme.RegisterPredefinedPaletteThemes();
ApplicationThemeHelper.ApplicationThemeName = PredefinedThemePalettes.RedWine.Name + Theme.Office2019White.Name;

VB.NET

Theme.RegisterPredefinedPaletteThemes()
ApplicationThemeHelper.ApplicationThemeName = PredefinedThemePalettes.RedWine.Name + Theme.Office2019White.Name

TIP：您可以使用 屬性來緩存當前調色板主題程序集，緩存減少了未來應用程序運行的加載時間。

上面的代碼示例為當前主題啟用了所有可用的調色板，要啟用和應用單個調色板：

1. 在您的項目中引用 NuGet 包。

2. 將調色板和基本主題傳遞給方法以創建新主題。

3. 將主題傳遞給 方法。

4. 將 屬性設置為主題名稱。

C#

var palettetheme = Theme.CreateTheme(PredefinedThemePalettes.RedWine, Theme.Office2019White);
Theme.RegisterTheme(palettetheme);
ApplicationThemeHelper.ApplicationThemeName = palettetheme.Name;

VB.NET

Dim palettetheme = Theme.CreateTheme(PredefinedThemePalettes.RedWine, Theme.Office2019White)
Theme.RegisterTheme(palettetheme)
ApplicationThemeHelper.ApplicationThemeName = palettetheme.Name

在Ribbon庫中顯示調色板

您可以在中顯示預定義的調色板，來允許用戶選擇調色板并將其應用于當前主題：

1. 參考 DevExpress.Mvvm.v21.1.dll 程序集。

2. 在應用程序啟動時調用 方法以啟用這些調色板：

C#

public partial class App : Application {
protected override void OnStartup(StartupEventArgs e) {
Theme.RegisterPredefinedPaletteThemes();
base.OnStartup(e);
}
}

VB.NET

Public Partial Class App
Inherits Application
Protected Overrides Sub OnStartup(ByVal e As StartupEventArgs)
Theme.RegisterPredefinedPaletteThemes()
MyBase.OnStartup(e)
End Sub
End Class

3. 將 RibbonGalleryItemThemePaletteSelectorBehavior 附加到 RibbonGalleryBarItem：

XAML

<dxr:RibbonGalleryBarItem ... >
<dxmvvm:Interaction.Behaviors>
<dxr:RibbonGalleryItemThemePaletteSelectorBehavior />
</dxmvvm:Interaction.Behaviors>
</dxr:RibbonGalleryBarItem>

使用 Windows 10 強調色

您可以使用帶有Windows 10 Light主題的Win10 Palette預定義調色板來獲取 Windows 10 強調色，并在您的應用程序中使用該顏色。

以下代碼示例使用 Windows 10 強調色創建新的 Win10Light 主題，并在應用程序啟動時應用該主題：

C#

protected override void OnStartup(StartupEventArgs e)
{
var accentpalette = new Win10Palette();
var customtheme = Theme.CreateTheme(accentpalette, Theme.Win10Light);
Theme.RegisterTheme(customtheme);
ApplicationThemeHelper.ApplicationThemeName = customtheme.Name;
base.OnStartup(e);
}

VB.NET

Protected Overrides Sub OnStartup(ByVal e As StartupEventArgs)
Dim accentpalette = New Win10Palette()
Dim customtheme = Theme.CreateTheme(accentpalette, Theme.Win10Light)
Theme.RegisterTheme(customtheme)
ApplicationThemeHelper.ApplicationThemeName = customtheme.Name
MyBase.OnStartup(e)
End Sub

注意：Win10 Palette僅適用于 Windows 10 操作系統版本，Win10 Palette 中沒有找到Windows 強調色，應用程序強調色設置為#FF0078D7。

自定義調色板

在代碼中編輯調色板

注意：當您切換主題時，應用程序不會卸載加載的主題程序集。

將自定義調色板應用于應用程序：

1. 在您的項目中引用 NuGet 包。

2. 創建一個新的 實例：

C#

var custompalette = new ThemePalette("CustomPalette");

VB.NET

Dim custompalette = New ThemePalette("CustomPalette")

...或基于預定義的調色板創建一個新的 ThemePalette 實例，在這種情況下，新調色板繼承了預定義調色板的顏色：

C#

var custompalette = new ThemePalette("CustomPalette", PredefinedThemePalettes.RedWine);

VB.NET

Dim custompalette = new ThemePalette("CustomPalette", PredefinedThemePalettes.RedWine)

3. 使用方法指定新顏色：

C#

custompalette.SetColor("Foreground", (Color)ColorConverter.ConvertFromString("#FFFF7200"));
custompalette.SetColor("Backstage.Focused", Colors.White);

VB.NET

custompalette.SetColor("Foreground", ColorConverter.ConvertFromString("#FF015C9F"))
custompalette.SetColor("Foreground", Colors.White)

將調色板和具有調色板支持的主題傳遞給 方法來創建新主題：

C#

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

VB.NET

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

將主題傳遞給方法并將設置為主題的名稱，來將主題應用于應用程序：

C#

var custompalette = new ThemePalette("CustomPalette");
custompalette.SetColor("Foreground", (Color)ColorConverter.ConvertFromString("#FFFF7200"));
custompalette.SetColor("Backstage.Focused", Colors.White);
var customtheme = Theme.CreateTheme(custompalette, Theme.Office2016ColorfulSE);
Theme.RegisterTheme(customtheme);
ApplicationThemeHelper.ApplicationThemeName = customtheme.Name;

VB.NET

Dim custompalette = New ThemePalette("CustomPalette")
custompalette.SetColor("Foreground", ColorConverter.ConvertFromString("#FF015C9F"))
custompalette.SetColor("Backstage.Focused", Colors.White)
Dim customtheme = Theme.CreateTheme(custompalette, Theme.Office2016ColorfulSE)
Theme.RegisterTheme(customtheme)
ApplicationThemeHelper.ApplicationThemeName = customtheme.Name

局限性

#在使用單個文件部署的 .NET 5 應用程序中在運行時更改主題
DevExpress WPF 主題程序集必須提取到磁盤，發布 .NET 5 應用程序（PublishSingleFile 為 true）時，將項目文件中的 IncludeAllContentForSelfExtract 選項設置為 true，這將允許用戶在運行時應用調色板。

XAML

<PropertyGroup>
<OutputType>WinExe</OutputType>
<TargetFramework>net5.0-windows</TargetFramework>
<UseWPF>true</UseWPF>
<Nullable>enable</Nullable>
<PublishSingleFile>true</PublishSingleFile>
<IncludeAllContentForSelfExtract>true</IncludeAllContentForSelfExtract>
</PropertyGroup>

DevExpress WPF | 下載試用

DevExpress WPF擁有120+個控件和庫，將幫助您交付滿足甚至超出企業需求的高性能業務應用程序。通過DevExpress WPF能創建有著強大互動功能的XAML基礎應用程序，這些應用程序專注于當代客戶的需求和構建未來新一代支持觸摸的解決方案。 無論是Office辦公軟件的衍伸產品，還是以數據為中心的商業智能產品，都能通過DevExpress WPF控件來實現。

DevExpress技術交流群4：715863792      歡迎一起進群討論