【WPF學習】第六十一章組織模板資源-有解無憂

　　為表達全國各族人民對抗擊新冠肺炎疫情斗爭犧牲烈士和逝世同胞的深切哀悼，國務院今天發布公告，決定2020年4月4日舉行全國性哀悼活動，

　　當使用控制元件模板時，需要決定如何更廣泛地共享模板，以及是否希望自動地或明確地位用模板，

　　第一個問題是關于希望在何處使用模板的問題，例如，是將它們限制在特定視窗中嗎?大多數情況下，控制元件模板應用于多個視窗，甚至可能應用于整個應用程式，為避免多次定義模板，可在Application類的Resources集合中定義模板資源，

　　然而，為此需要考慮另一個事項，通常，控制元件模板在多個應用程式之間共享，單個應用程式很有可能使用單獨開發的模板，然而，一個應用程式只能有一個App.xaml檔案和一個Application.Resources集合，因此，在單獨資源字典中定義資源是一個更好的主意，這樣，可靈活地再特定視窗或在整個應用程式中使用資源，而且還可以結合使用樣式，因為任何應用程式都可以包含多個資源字典，為在Visual Studio中添加資源字典，在Solution Explorer視窗中右擊專案，選擇Add|New Item選單項，然后選擇Resources Dictionary(WPF)模板，

　　在前面章節中介紹了資源字典，使用它們很容易，只需要為應用程式添加一個新的具有如下內容的XAML檔案即可：

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
    >
    <ControlTemplate x:Key="GradientButtonTemplate" TargetType="{x:Type Button}">
        ...
    </ControlTemplate>
</ResourceDictionary>

　　雖然可將所有模板組合到單個資源字典檔案中，但富有經驗的開發人員更愿意為每個控制元件模板創建單獨的資源字典，這是因為控制元件模板可能很快地變得過于復雜，并可能需要使用其他相關資源，將它們保存在一個單獨的地方，并與其他控制元件相隔離，是一種很好的組織方式，

　　為使用資源字典，只需要將他們添加到特定視窗或應用程式(這種情況更常見)的Resources集合中，可使用MergedDictionaries集合完成該作業，例如，如果按鈕模板在專案檔案夾的Resources子檔案夾下的Button.xaml檔案中，就可以在App.xaml檔案中使用以下標記：

<Application x:Class="ControlTemplates.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    StartupUri="Menu.xaml"
    >
    <Application.Resources>
            <ResourceDictionary>
               <ResourceDictionary.MergedDictionaries>
                  <ResourceDictionary Source="Resources\Button.xaml"/>
               </ResourceDictionary.MergedDictionaries>
             </ResourceDictionary>
    </Application.Resources>
</Application>

一、分解按鈕控制元件模板

　　當完善或擴展控制元件模板時，可發現其中封裝了大量的不同細節，包括特定的形狀、幾何圖形和畫刷，從控制元件模板中提取這些細節并將他們定義為單獨的資源是一個好主意，一個原因是通過該步驟，可以更方便地再一組相關的控制元件中重用這些畫刷，例如，可能會決定創建使用相同的自定義Button、CheckBox和RadioButton控制元件，為使該作業更加容易，可為畫刷(名為Brushes.xaml)創建一個單獨的資源字典，并將該資源字典合并到每個控制元件(如Button.xaml、CheckBox.xaml和RadioButton.xaml)的資源字典中，

　　為查看這種技術的作業情況，分析下嗎的標記，這些標記代表了一個按鈕的完整資源字典，包括控制元件模板使用的資源、控制元件模板，以及為應用程式中每個按鈕應用控制元件模板的樣式規則，始終需要遵循這一順序，因為資源需要在使用之前先定義(如果在模板之后定義畫刷，將收到錯誤資訊，因為模板找不到所需的畫刷)，

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <!-- Resources used by the template. -->
    <RadialGradientBrush RadiusX="1" RadiusY="5" GradientOrigin="0.5,0.3"
                         x:Key="HighlightBackground">
        <GradientStop Color="White" Offset="0"/>
        <GradientStop Color="Blue" Offset="0.4"/>
    </RadialGradientBrush>
    <RadialGradientBrush RadiusX="1" RadiusY="5" GradientOrigin="0.5,0.3"
                         x:Key="PressedBackground">
        <GradientStop Color="White" Offset="0"/>
        <GradientStop Color="Blue" Offset="1"/>
    </RadialGradientBrush>

    <SolidColorBrush Color="Blue" x:Key="DefaultBackground"></SolidColorBrush>
    <SolidColorBrush Color="Gray" x:Key="DisabledBackground"></SolidColorBrush>

    <RadialGradientBrush RadiusX="1" RadiusY="5" GradientOrigin="0.5,0.3"
                         x:Key="Border">
        <GradientStop Color="White" Offset="0"/>
        <GradientStop Color="Blue" Offset="1"/>
    </RadialGradientBrush>

    <!-- The button control template. -->
    <ControlTemplate x:Key="GradientButtonTemplate" TargetType="{x:Type Button}">
        <Border Name="Border" BorderBrush="{StaticResource Border}" BorderThickness="2"
       CornerRadius="2" Background="{StaticResource DefaultBackground}"
       TextBlock.Foreground="White">
            <Grid>
                <Rectangle Name="FocusCue" Visibility="Hidden" Stroke="Black"
           StrokeThickness="1" StrokeDashArray="1 2" SnapsToDevicePixels="True">
                </Rectangle>
                <ContentPresenter Margin="{TemplateBinding Padding}"
           RecognizesAccessKey="True"></ContentPresenter>
            </Grid>
        </Border>
        <ControlTemplate.Triggers>
            <Trigger Property="IsMouseOver" Value="True">
                <Setter TargetName="Border" Property="Background"
           Value="{StaticResource HighlightBackground}" />
            </Trigger>
            <Trigger Property="IsPressed" Value="True">
                <Setter TargetName="Border" Property="Background"
           Value="{StaticResource PressedBackground}" />
            </Trigger>
            <Trigger Property="IsKeyboardFocused" Value="True">
                <Setter TargetName="FocusCue" Property="Visibility"
            Value="Visible"></Setter>
            </Trigger>
            <Trigger Property="IsEnabled" Value="False">
                <Setter TargetName="Border" Property="Background"
           Value="{StaticResource DisabledBackground}"></Setter>
            </Trigger>
        </ControlTemplate.Triggers>
    </ControlTemplate>
</ResourceDictionary>

　　下圖顯示了該模板定義的按鈕，在該例中，當用戶滑鼠移到按鈕上時，使用漸變填充，然而，漸變中心位于按鈕中央，如果希望創建更新穎的效果，例如跟隨滑鼠位置的漸變，就需要使用影片或者撰寫代碼，

二、通過樣式應用模板

　　這種設計存在局限性，控制元件模板本質上硬編碼了一些細節，如顏色方案，這意味著如果希望在按鈕中使用相同的元素組合(Border、Grid、Rectangle和ContentPresenter)并采用相同的方式安排它們，但希望提供不同的顏色方案，就必須創建應用不同畫刷資源的新模板副本，

　　這未必是個問題(畢竟，布局和格式化細節可能緊密相關，以至于不希望以任何方式隔離它們)，但這確實限制了重用控制元件模板的能力，如果模板使用了元素的復合排列方式，并且希望重用這些具有各種不同格式化細節(通常是顏色和字體)的元素，可從模板中將這些細節提取出來，并將它們放到樣式中，

　　為此，需要重新撰寫模板，這次不能使用硬編碼的顏色，而需要使用模板系結從控制元件屬性中提取出資訊，下面的示例為前面看到的特殊按鈕定義了一個精簡模板，控制元件模板將一些細節作為基礎的固定要素——焦點框和兩個單位寬的圓角邊框，背景和邊框畫刷是可配置的，唯一需要保留的觸發器是顯示焦點框的那個觸發器：

<ControlTemplate x:Key="GradientButtonTemplate" TargetType="{x:Type Button}">
        <Border Name="Border" BorderThickness="2" CornerRadius="2"
              Background="{TemplateBinding Background}" BorderBrush="{TemplateBinding BorderBrush}">
            <Grid>
                <Rectangle Name="FocusCue" Visibility="Hidden" Stroke="Black"
           StrokeThickness="1" StrokeDashArray="1 2" SnapsToDevicePixels="True">
                </Rectangle>
                <ContentPresenter Margin="{TemplateBinding Padding}"
           RecognizesAccessKey="True"></ContentPresenter>
            </Grid>
        </Border>
        <ControlTemplate.Triggers>
            <Trigger Property="IsKeyboardFocused" Value="True">
                <Setter TargetName="FocusCue" Property="Visibility"
            Value="Visible"></Setter>
            </Trigger>
        </ControlTemplate.Triggers>
    </ControlTemplate>

　　關聯的樣式應用這個控制元件模板，設定邊框和背景顏色，并添加觸發器以便根據按鈕的狀態改變背景色：

<!-- The style that applies the button control template. -->
    <Style TargetType="{x:Type Button}">
        <Setter Property="Control.Template"
       Value="{StaticResource GradientButtonTemplate}"></Setter>
        <Setter Property="BorderBrush"
       Value="{StaticResource Border}"></Setter>
        <Setter Property="Background"
         Value="{StaticResource DefaultBackground}"></Setter>
        <Setter Property="TextBlock.Foreground"
           Value="White"></Setter>
        <Style.Triggers>
            <Trigger Property="IsMouseOver" Value="True">
                <Setter Property="Background"
           Value="{StaticResource HighlightBackground}" />
            </Trigger>
            <Trigger Property="IsPressed" Value="True">
                <Setter Property="Background"
           Value="{StaticResource PressedBackground}" />
            </Trigger>
            <Trigger Property="IsEnabled" Value="False">
                <Setter Property="Background"
           Value="{StaticResource DisabledBackground}"></Setter>
            </Trigger>
        </Style.Triggers>
    </Style>

　　理想情況下，應能在控制元件模板中保留所有觸發器，因為它們代表控制元件的行為，并使用樣式簡單設定基本屬性，但在此如果希望樣式能夠設定顏色方案，是不可能實作的，

　　為使用這個新模板，需要設定按鈕的Style屬性而不是Template屬性：

<Button Margin="10" Padding="5" Style="{StaticResource CustomButtonStyle}"
              >A Simple Button with a Custom Template</Button>

　　現在可創建一些新樣式，這些樣式使用相同的模板，但為了應用新的顏色方案，應將模板系結到不同的畫刷，

　　使用這種方法存在的重要限制，在該樣式中不能使用Setter.TargetName屬性，因為樣式不包含控制元件模板(只是參考模板而已)，因此，樣式和觸發器有一定的限制，它們不能深入到可視化樹中來改變嵌套的元素的這個方面，反而，樣式需要設定控制元件的屬性，而且控制元件中的元素需要使用模板來系結來系結，

三、自動應用模板

　　在當前示例中，每個按鈕負責使用Template或Style屬性將自身關聯到適當模板，如果使用控制元件模板，在應用程式中的特定位置創建特殊效果，這是合理的，但如果希望在具有自定義外觀的整個應用程式中改變每個按鈕的皮膚，這就不是很方便了，對于這種情況，可能會更希望應用程式中的所有按鈕自動請求新的模板，為實作該功能，需要通過樣式應用控制元件模板，

　　技巧是使用型別樣式，這種樣式會自動影響回應的元素型別并設定Template屬性，下面是一個樣式示例，應將該樣式放到資源字典的資源集合中，從而為按鈕提供新外觀：

<Style TargetType="{x:Type Button}">
        <Setter Property="Control.Template"
       Value="{StaticResource GradientButtonTemplate}"></Setter>
    </Style>

　　上面的代碼可以作業，原因是樣式沒有指定鍵名，這意味著改用元素型別(Button)，

　　請記住，仍可通過創建一個按鈕并將其Style屬性明確設定為null值，退出該樣式：

<Button Style="{x:Null}" ...></Button>

　　包含基于型別的樣式的組合的資源字典通常(非正式地)被稱為主題(theme)，主題能夠實作非凡的效果，通過主題可為已有應用程式的所有控制元件重新應用皮膚，而根本不需要改用戶界面標記，需要做的全部作業就是為專案添加資源字典，并將其合并到App.xaml檔案的Application.Resources集合中，

　　如果在Web上搜索，可找到許多能用于為WPF應用程式換膚的主題，例如，可下載WPF Futures版本中的幾個示例主題，

　　為使用主題，為專案添加包含資源字典的.xaml檔案，例如，WPF Futuers提供了一個名為ExpressionDark.xaml的主題檔案，然后，需要在應用程式中激活樣式，可逐個視窗地完成該作業，但更快捷的方法是通過添加如下所示的標記在應用程式級別匯入他們：

<Application ...>
    <Application.Resources>
        <ResourceDictionary Source="ExpressionDark.xaml"/>
    </Application.Resources>
</Application>

　　現在將全面實施資源字典中基于型別的樣式，并將自動改變應用程式每個視窗的每個通用控制元件的外觀，如果是一位正在搜索熱門用戶界面的應用程式開發人員，但不具備自己構建這類用戶界面的設計技能，那么使用該技巧幾乎不需要付出努力就能很容易地插入第三方的精彩界面，

四、由用戶選擇的皮膚

　　在一些應用程式中，可能希望動態改變模板，通常是根據用戶的個人愛好加以改變，這很容易發現，但檔案沒有對比進行詳細說明，基本技術是在運行時加載新的資源字典，并使用新加載的資源字典代替當前的資源字典(不需要替換所有資源，字需要替換那些勇于皮膚的資源)，

　　訣竅在于檢索ResourceDictionary物件，該物件經過編譯并作為資源嵌入到應用程式中，最簡單的方法是使用ResourceManager類來加載所需資源，

　　例如，假定已創建用于定義同一個按鈕控制元件模板的替代版本的兩個資源，其中一個保存在GradientButton.xaml檔案中，而另一個保存在GradientButtonVariant.xaml檔案中，為了更好地組織資源，這兩個檔案都位于當前專案的Resources子檔案夾中，

　　現在可創建一個簡單的視窗，通過Resources集合使用這些資源中的一個，如下所示：

 <Window.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="Resources/GradientButton.xaml"></ResourceDictionary>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Window.Resources>

　　現在可通過如下代碼使用不同的資源字典：

ResourceDictionary resourceDictionary = new ResourceDictionary();
            resourceDictionary.Source = new Uri(
              "Resources/GradientButtonVariant.xaml", UriKind.Relative);
            this.Resources.MergedDictionaries[0] = resourceDictionary;

　　上面的代碼加載GradientButtonVariant資源字典，并將它放置到MergedDictionaries集合的第一個位置，在此沒有清空MergedDictionaries集合或其他任何視窗的資源，因為可能鏈接到了其他席位繼續使用的資源字典，也沒有為MergedDictionaries集合添加新條目，因為這可能與位于不同集合中的同名資源發生沖突，

　　如果正在為整個應用程式改變皮膚，可使用相同的方法，但應使用應用程式的資源字典，可使用如下代碼更新這個資源字典：

Application.Current.Resources.MergedDictionaries[0]=newDictionary;

　　還可使用pack URI語法加載在另一個程式集合中的資源字典：

ResourceDictionary resourceDictionary = new ResourceDictionary();
            resourceDictionary.Source = new Uri(
              "ControlTemplates;component/GradientButtonVariant.xaml", UriKind.Relative);
            this.Resources.MergedDictionaries[0] = resourceDictionary;

　　當加載新的資源字典時，會自動使用新模板更新所有按鈕，如果當修改控制元件時不需要完全改變皮膚，還可以為皮膚提供基本樣式，

　　該例假定GradientButton.xaml和GradientButtonVariant.xaml資源使用元素型別樣式自動改變按鈕，還有一種方法——通過手動設定Button物件的Template或Style屬性來選用新的模板，如果使用這種方法，務必使用DynamicResource應用，而不能使用StaticResource，如果使用Resource，當切換皮膚時不會更新按鈕模板，

　　還有一種通過撰寫代碼加載資源字典的方法，可使用與為視窗創建帶阿媽隱藏類幾乎相同的方法，為資源字典創建代碼隱藏類，然后就可以直接實體化這個類，而不是使用ResourceDictionary.Source屬性，這種方法有一個優點，他是強型別的(沒有機會為Source屬性輸入無效的URI)，并且可為資源類添加屬性、方法以及其他功能，例如，可以使用這種方法，為自定義視窗模板創建具有事件處理代碼的資源，

　　盡管為資源字典創建代碼隱藏類很容易，但Visual Studio不能自動完成該作業，需要為繼承自ResourceDictionary的部分類添加代碼檔案，并為建構式中呼叫InitializeComponent()方法：

public partial class GradientButtonVariant : ResourceDictionary
    {
        public GradientButtonVariant()
        {
            InitializeComponent();
        }
    }

　　這里使用的類名為GradientButtonVariant,而且該類存盤在GradientButtonVariant.xaml.cs檔案中，包含資源的XAML檔案被命名為GradientButtonVariant.xaml，不是必須使用一致的名稱，但這是一個好主意，并且在創建視窗以及創建頁面時也遵循了Visual Studio使用的這一約定，

　　接下來將類鏈接到資源字典，通過為資源字典的根元素添加Class特性完成該作業，就想為視窗應用Class特性一樣，并且可為任何XAML類應用Class特性，然后提供完全限定的類名，在這個示例中，專案名稱是ControlTemplates，因此這是默認名稱空間，最后的標簽可能如下所示：

<ResourceDictionary x:Class="ControlTemplates.GradientButtonVariant">

　　現在可使用該代碼創建資源字典并將它應用于視窗：

GradientButtonVariant newDict = new GradientButtonVariant();
this.Resources.MergedDictionaries[0] = newDict;

　　在Solution Explorer中，如果希望GradientButtonVariant.xaml.cs檔案嵌套在GradientButtonVariant.xaml檔案的下面，需要在文本編輯器中修改.csproj專案檔案，在<ItemGroup>部分，找到代碼因此檔案，并將下面的代碼:

<Compile Include="Resources\GradientButtonVariant.xaml.cs"/>

　　修改為:

<Compile Include="Resources\GradientButtonVariant.xaml.cs">
    <DependentUpon>Resources\GradientButtonVariant.xaml</DependentUpon>
</Compile>

轉載請註明出處，本文鏈接：https://www.uj5u.com/net/155.html

標籤：WPF

上一篇：【WPF學習】第六十章創建控制元件模板

下一篇：通過反編譯得到System.Core程式集中System.Linq命名空間下的Enumerable類

【WPF學習】第六十一章 組織模板資源

【WPF學習】第六十一章組織模板資源