修改主題資源

---

立即下載DevExpress WPF

您可以自定義視覺元素的主題資源(筆刷、厚度、顏色、樣式、模板等)，如下所述。

如果您使用DevExpress WPF Controls NuGet包，則應該在計算機上安裝DevExpress WPF Controls ，安裝包括DevExpress WPF主題源代碼。

使用WPF主題設計器

 WPF主題設計器是一個獨立的工具，允許您基于內置的DevExpress WPF應用程序主題創建自定義主題。

要使用WPF主題設計器更改主題資源，請執行以下步驟：

1. 從DevExpress WPF控件單獨。
2. 創建自定義主題。
3. 使用Inspect Element工具定位要更改其外觀的。
4. 。
5. 導出帶有自定義主題的程序集。
6. 在應用程序中。

主題： 主題設計器 - 創建并應用新的自定義主題。

優點

• 可以將修改后的主題導出為程序集。
• 您可以使用Inspect Element工具來定位元素的屬性和XAML源代碼。
• 自定義主題升級工具允許將自定義主題更新到新版本的DevExpress WPF控件，并解決可能的更新沖突。
• 允許將自定義主題應用于DevExpress WPF控件，并查看更改的預覽。

缺點

• 您應該從DevExpress WPF控件中單獨 。

在應用程序代碼中使用XAML資源

 您可以從DevExpress WPF控件源代碼中復制主題資源[1]到應用程序中，修改這些主題資源，并在項目中使用它們作為。

優點

• 與使用WPF主題設計器相比，修改主題資源的步驟更少。
• 您可以在所有DevExpress WPF主題中使用修改過的主題資源。

部分：將修改后的主題資源應用到應用程序中。

缺點

• 您需要在應用程序的可視化樹中找到一個控件元素，并確定應該更改的主題資源[1]。
• 當升級到較新版本的DevExpress WPF控件時，可能會遇到更新問題。

查找元素的主題資源

 要訪問元素的主題資源[1]，請在應用程序的可視化樹中找到該元素。您可以使用Visual Studio的、Snoop(在本主題中使用)、WPF主題設計器檢查元素工具或其他分析可視化樹的工具。

這篇文章展示了如何搜索定義GridColumn過濾器圖標外觀的模板：

1.在可視化樹中找到一個元素

使用將Snoop工具附加到應用程序上。

 按住Ctrl+Shift并將鼠標指針懸停在網格列的過濾器圖標上，這個圖標由一個帶有四個路徑項的網格組成。

2.確定要更改的項目

使用項的唯一屬性標識要更改的項：控件類型、名稱或屬性，這個示例使用了Path的Data屬性。

3.在主題源代碼中找到元素

在要更改其外觀的DevExpress WPF主題的源代碼中找到元素，您可以使用Visual Studio的內置搜索工具(在本主題中使用)、WPF主題設計器的個人或其他可以搜索文件中的文本的工具。

 按照下面的步驟在Office2016White主題的源代碼中找到GridColumn過濾器圖標的模板。

• 打開Office2016White主題的項目，默認文件夾路徑為C:\Program Files\DevExpress 23.1\Components\Sources\XPF\DevExpress.Xpf.Themes\Office2016White\Office2016White.csproj。
• 搜索Path的Data屬性值為F1 M 1296.5的元素。

如何修改主題資源的建議

 當修改主題資源時，您的修改可能會影響DevExpress WPF控件，并導致異常或不正確的操作等問題。為了避免這些問題，我們建議您遵循以下說明。

• 不要刪除名稱以PART_開頭的元素，也不要更改這些元素的名稱/類型，DevExpress WPF控件可以在代碼隱藏中使用它們。要hide these elements則將元素的Visibility屬性設置為collapse，這種方法在下一點中描述的場景中沒有效果。
• DevExpress WPF控件可能會改變PART_編輯器在代碼隱藏中的可見性，不要修改這些主題資源中的Visibility屬性[1]。要hide these elements則將它們的不透明度屬性值設置為0。
• 不要從復雜的筆刷中移除元素，動畫的DevExpress WPF控件使用這些元素。

 下面的代碼片段包含了一個帶有GradientStop元素的復雜LinearGradientBrush的例子：

<LinearGradientBrush EndPoint="0.5,1" StartPoint="0.5,0">
<GradientStop Color="#FFD1E4FC" Offset="0" />
<GradientStop Color="#FFAED1F6" Offset="1" />
<GradientStop Color="#FFB5D0F1" Offset="0.5" />
<GradientStop Color="#FFA4C5ED" Offset="0.5" />
</LinearGradientBrush>

• DevExpress WPF控件可能包含cs：Name屬性，您應該從自定義主題資源中刪除它，或者指定以下XML名稱空間來忽略它：

<Window ...
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:cs="colorscheme_ignorable_uri"
mc:Ignorable="cs">
<Window.Resources>
<ControlTemplate x:Key="{dxgt:GridColumnHeaderThemeKey ResourceKey=ControlTemplate}"
TargetType="{x:Type dxg:GridColumnHeaderBase}">
<Grid>
<!-- ... -->
<Border ...
cs:Name="Border_0001"/>
</Grid>
</ControlTemplate>
</Window.Resources>
</Window>

將修改后的主題資源應用到應用程序中

將修改后的主題[1]粘貼到目標元素(控件、窗口或應用程序)的資源中，并選擇以下選項之一：

• 要將修改后的資源應用于所有DevExpress WPF主題，請將資源的IsThemeIndependent屬性設置為true。下面的代碼示例修改了所有DevExpress WPF主題中窗口內所有GridColumnHeaderBase元素的資源：

<Window ...
xmlns:dxgt="http://schemas.devexpress.com/winfx/2008/xaml/grid/themekeys">
<Window.Resources>
<ControlTemplate x:Key="{dxgt:GridColumnHeaderThemeKey ResourceKey = ColumnFilterTemplate, IsThemeIndependent = true}">
<!-- ... -->
</ControlTemplate>
</Window.Resources>
</Window>

• 要修改specific theme，請指定資源的ThemeName屬性，您可以在主題中找到可用的ThemeName屬性值列表(請參閱主題名稱列)。下面的代碼示例只修改Office2019Colorful主題中的資源：

<Window ...
xmlns:dxgt="http://schemas.devexpress.com/winfx/2008/xaml/grid/themekeys">
<Window.Resources>
<ControlTemplate x:Key="{dxgt:GridColumnHeaderThemeKey ResourceKey=ColumnFilterTemplate,ThemeName=Office2019Colorful}" TargetType="{x:Type ToggleButton}">
<!-- ... -->
</ControlTemplate>
</Window.Resources>
</Window>

 如果您沒有指定資源的IsThemeIndependent或ThemeName屬性，則該資源僅在DeepBlue主題中應用。

修改主題資源要求

修改后的主題資源[1]應滿足以下要求：

1.確保主題資源對其目標元素可見。

主題：。

2.引用程序集并復制主題資源使用的名稱空間。

3.將彈出窗口和消息框中使用的主題資源放在App.xaml資源中。

 4.如果主題資源使用靜態資源(brush、Converters等)，也應該將它們復制到應用程序中。

使用不同主題的不同主題資源

1. 為使用的每個主題創建主題資源[1]。
2. 為每個創建的主題資源指定ThemeName屬性。

您可以在主題列表主題中找到可用的ThemeName屬性值列表(請參閱主題名稱列)。

下面的代碼示例使用和應用程序主題的不同模板：

<Window ...
xmlns:dxgt="http://schemas.devexpress.com/winfx/2008/xaml/grid/themekeys">
<Window.Resources>
<ControlTemplate x:Key="{dxgt:GridColumnHeaderThemeKey ResourceKey=ColumnFilterTemplate,ThemeName=Office2013}" TargetType="{x:Type ToggleButton}">
<!-- ... -->
</ControlTemplate>
<ControlTemplate x:Key="{dxgt:GridColumnHeaderThemeKey ResourceKey=ColumnFilterTemplate,ThemeName=MetropolisDark}" TargetType="{x:Type ToggleButton}">
<!-- ... -->
</ControlTemplate>
</Window.Resources>
</Window>

使用主題的動態資源

原始主題資源可以使用主題的動態資源：

<Window ...
xmlns:dxgt="http://schemas.devexpress.com/winfx/2008/xaml/grid/themekeys">
<Window.Resources>
<ControlTemplate ...>
<Grid>
<Border BorderBrush="{DynamicResource {dxgt:TableViewThemeKey ResourceKey=ColumnChooserBorderBrush}}">
</Grid>
</ControlTemplate>
<Window.Resources>
</Window>

 如果您指定修改后的資源的IsThemeIndependent屬性，它仍然使用默認主題(DeepBlue)的資源，要使用應用主題中的資源，請執行以下步驟：

1. 引用dxi="http://schemas.devexpress.com/winfx/2008/xaml/core/internal" XAML命名空間。
2. 將修改后的主題資源的DynamicResource更改為dxi：ThemeResource。themerresource標記擴展動態地將其目標屬性設置為目標元素應用的主題中的資源，目標元素必須位于應用程序的可視化樹中。

<TargetElement TargetProperty="{dxi:ThemeResource {ThemeKey}}" />

 下面的代碼示例將Border的(TargetElement) BorderBrush (TargetProperty)屬性值設置為目標元素應用的主題中的一個資源(ThemeKey)：

<Window ...
xmlns:dxi="http://schemas.devexpress.com/winfx/2008/xaml/core/internal"
xmlns:dxgt="http://schemas.devexpress.com/winfx/2008/xaml/grid/themekeys">
<Window.Resources>
<ControlTemplate ...>
<Grid>
<Border BorderBrush="{dxi:ThemeResource {dxgt:TableViewThemeKey ResourceKey=ColumnChooserBorderBrush}}">
</Grid>
</ControlTemplate>
<Window.Resources>
</Window>

查看示例：