样式和模板 (WPF .NET)

Windows Presentation Foundation (WPF) 样式设置和模板化是指一套功能，这套功能使开发者和设计者能够为其产品创建极具视觉表现力的效果和一致的外观。 自定义应用的外观时，需要一个强大的样式设置和模板化模型，以便维护和共享应用内部和应用之间的外观。 WPF 就提供了这样的模型。

WPF 样式设置模型的另一项功能是将呈现与逻辑分离。 设计者可以仅使用 XAML 处理应用外观，与此同时开发者使用 C# 或 Visual Basic 处理编程逻辑。

本概述侧重于应用的样式设置和模板化两方面，不讨论任何数据绑定概念。 有关数据绑定的信息，请参阅数据绑定概述。

了解资源很重要，正是这些资源使样式和模板能够重复使用。 有关资源的详细信息，请参阅 XAML 资源概述。

重要

面向 .NET 7 和 .NET 6 的桌面指南文档正在撰写中。

示例

本概述中提供的示例代码基于下图所示的简单照片浏览应用程序。

此简单照片示例使用样式设置和模板化创建极具视觉表现力的用户体验。 该示例具有两个 TextBlock 元素和一个绑定到图像列表的 ListBox 控件。

有关完整示例，请参阅样式设置和模板化示例简介。

样式

可以将 Style 视为一种将一组属性值应用到多个元素的便捷方法。 可以对从 FrameworkElement 或 FrameworkContentElement（如 Window 或 Button）派生的任何元素使用样式。

声明样式的最常见方法是在 XAML 文件的 Resources 部分中声明为资源。 由于样式是一种资源，因此它们同样遵从适用于所有资源的范围规则。 简而言之，声明样式的位置会影响样式的应用范围。 例如，如果在应用定义 XAML 文件的根元素中声明样式，则该样式可以在应用中的任何位置使用。

例如，以下 XAML 代码为 TextBlock 声明了两个样式，一个自动应用于所有 TextBlock 元素，另一个则必须显式引用。

<Window.Resources>
    <!-- .... other resources .... -->

    <!--A Style that affects all TextBlocks-->
    <Style TargetType="TextBlock">
        <Setter Property="HorizontalAlignment" Value="Center" />
        <Setter Property="FontFamily" Value="Comic Sans MS"/>
        <Setter Property="FontSize" Value="14"/>
    </Style>
    
    <!--A Style that extends the previous TextBlock Style with an x:Key of TitleText-->
    <Style BasedOn="{StaticResource {x:Type TextBlock}}"
           TargetType="TextBlock"
           x:Key="TitleText">
        <Setter Property="FontSize" Value="26"/>
        <Setter Property="Foreground">
            <Setter.Value>
                <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
                    <LinearGradientBrush.GradientStops>
                        <GradientStop Offset="0.0" Color="#90DDDD" />
                        <GradientStop Offset="1.0" Color="#5BFFFF" />
                    </LinearGradientBrush.GradientStops>
                </LinearGradientBrush>
            </Setter.Value>
        </Setter>
    </Style>
</Window.Resources>

下面举例说明了如何使用上面声明的样式。

<StackPanel>
    <TextBlock Style="{StaticResource TitleText}" Name="textblock1">My Pictures</TextBlock>
    <TextBlock>Check out my new pictures!</TextBlock>
</StackPanel>

有关详细信息，请参阅为控件创建样式。

ControlTemplate

在 WPF 中，控件的 ControlTemplate 用于定义控件的外观。 可以通过定义新的 ControlTemplate 并将其分配给控件来更改控件的结构和外观。 在许多情况下，模板提供了足够的灵活性，从而无需自行编写自定义控件。

每个控件都有一个分配给 Control.Template 属性的默认模板。 该模板将控件的视觉呈现与控件的功能关联起来。 因为在 XAML 中定义了模板，所以无需编写任何代码即可更改控件的外观。 每个模板都是为特定控件（例如 Button）设计的。

通常在 XAML 文件的 Resources 部分中将模板声明为资源。 与其他所有资源一样，范围规则在此也适用。

控件模板比样式复杂得多。 这是因为控件模板重写了整个控件的视觉外观，而样式只是将属性更改应用于现有控件。 但是，控件模板是通过设置 Control.Template 属性来应用的，因此可以使用样式来定义或设置模板。

设计器通常允许创建现有模板的副本并进行修改。 例如，在 Visual Studio WPF 设计器中，选择一个 CheckBox 控件，然后右键单击并选择“编辑模板”>“创建副本”。 此命令会生成一个用于定义模板的样式。

<Style x:Key="CheckBoxStyle1" TargetType="{x:Type CheckBox}">
    <Setter Property="FocusVisualStyle" Value="{StaticResource FocusVisual1}"/>
    <Setter Property="Background" Value="{StaticResource OptionMark.Static.Background1}"/>
    <Setter Property="BorderBrush" Value="{StaticResource OptionMark.Static.Border1}"/>
    <Setter Property="Foreground" Value="{DynamicResource {x:Static SystemColors.ControlTextBrushKey}}"/>
    <Setter Property="BorderThickness" Value="1"/>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type CheckBox}">
                <Grid x:Name="templateRoot" Background="Transparent" SnapsToDevicePixels="True">
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="Auto"/>
                        <ColumnDefinition Width="*"/>
                    </Grid.ColumnDefinitions>
                    <Border x:Name="checkBoxBorder" Background="{TemplateBinding Background}" BorderThickness="{TemplateBinding BorderThickness}" BorderBrush="{TemplateBinding BorderBrush}" HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}" Margin="1" VerticalAlignment="{TemplateBinding VerticalContentAlignment}">
                        <Grid x:Name="markGrid">
                            <Path x:Name="optionMark" Data="F1 M 9.97498,1.22334L 4.6983,9.09834L 4.52164,9.09834L 0,5.19331L 1.27664,3.52165L 4.255,6.08833L 8.33331,1.52588e-005L 9.97498,1.22334 Z " Fill="{StaticResource OptionMark.Static.Glyph1}" Margin="1" Opacity="0" Stretch="None"/>
                            <Rectangle x:Name="indeterminateMark" Fill="{StaticResource OptionMark.Static.Glyph1}" Margin="2" Opacity="0"/>
                        </Grid>
                    </Border>
                    <ContentPresenter x:Name="contentPresenter" Grid.Column="1" Focusable="False" HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}" Margin="{TemplateBinding Padding}" RecognizesAccessKey="True" SnapsToDevicePixels="{TemplateBinding SnapsToDevicePixels}" VerticalAlignment="{TemplateBinding VerticalContentAlignment}"/>
                </Grid>
                <ControlTemplate.Triggers>
                    <Trigger Property="HasContent" Value="true">
                        <Setter Property="FocusVisualStyle" Value="{StaticResource OptionMarkFocusVisual1}"/>
                        <Setter Property="Padding" Value="4,-1,0,0"/>

... content removed to save space ...

通过编辑模板副本可以很好地了解模板的工作原理。 与其新建一个空白模板，不如编辑副本并更改视觉呈现的某些方面来得简单。

有关示例，请参阅为控件创建模板。

TemplateBinding

你可能已经注意到，上一部分中定义的模板资源使用了 TemplateBinding 标记扩展。 对于模板方案来说，TemplateBinding 是绑定的优化形式，类似于使用 {Binding RelativeSource={RelativeSource TemplatedParent}} 构造的绑定。 TemplateBinding 可用于将模板的各个部分绑定到控件的各个属性。 例如，每个控件都有一个 BorderThickness 属性。 可使用 TemplateBinding 管理此控件设置影响模板中的哪个元素。

ContentControl 和 ItemsControl

如果在 ContentControl 的 ControlTemplate 中声明了 ContentPresenter，ContentPresenter 将自动绑定到 ContentTemplate 和 Content 属性。 同样，ItemsControl 的 ControlTemplate 中的 ItemsPresenter 将自动绑定到 ItemTemplate 和 Items 属性。

DataTemplate

在此示例应用中，有一个绑定到照片列表的 ListBox 控件。

<ListBox ItemsSource="{Binding Source={StaticResource MyPhotos}}"
         Background="Silver" Width="600" Margin="10" SelectedIndex="0"/>

此 ListBox 当前如下所示。

大多数控件都具有某些类型的内容，并且该内容通常来自要绑定到的数据。 在此示例中，数据是照片列表。 在 WPF 中，使用 DataTemplate 定义数据的视觉表示形式。 基本上，放入 DataTemplate 的内容决定了数据在呈现的应用中的外观。

在示例应用中，每个自定义 Photo 对象都有一个字符串类型的 Source 属性，用于指定图像的文件路径。 当前，照片对象显示为文件路径。

public class Photo
{
    public Photo(string path)
    {
        Source = path;
    }

    public string Source { get; }

    public override string ToString() => Source;
}

Public Class Photo
    Sub New(ByVal path As String)
        Source = path
    End Sub

    Public ReadOnly Property Source As String

    Public Overrides Function ToString() As String
        Return Source
    End Function
End Class

若要使照片显示为图像，请将 DataTemplate 创建为资源。

<Window.Resources>
    <!-- .... other resources .... -->

    <!--DataTemplate to display Photos as images
    instead of text strings of Paths-->
    <DataTemplate DataType="{x:Type local:Photo}">
        <Border Margin="3">
            <Image Source="{Binding Source}"/>
        </Border>
    </DataTemplate>
</Window.Resources>

请注意，DataType 属性与 Style 的 TargetType 属性相似。 如果 DataTemplate 在 resources 部分中，则在将 DataType 属性指定为某个类型并且省略 x:Key 时，只要该类型出现，就会应用 DataTemplate。 始终可以选择为 DataTemplate 分配 x:Key，然后将其设置为采用 DataTemplate 类型的属性（例如 ItemTemplate 属性或 ContentTemplate 属性）的 StaticResource。

实质上，上述示例中的 DataTemplate 定义每当存在 Photo 对象时，它都应显示为 Border 内的 Image。 有了这个 DataTemplate，我们的应用现在如下所示。

数据模板化模型提供其他功能。 例如，如果要使用 HeaderedItemsControl 类型（例如 Menu 或 TreeView）显示包含其他集合的集合数据，可以使用 HierarchicalDataTemplate。 另一个数据模板化功能是 DataTemplateSelector，该功能允许基于自定义逻辑选择要使用的 DataTemplate。 有关详细信息，请参阅数据模板化概述，该概述提供不同数据模板化功能的更多深入讨论。

触发器

触发器在属性值发生更改或引发事件时设置属性或启动操作，例如动画。 Style、ControlTemplate 和 DataTemplate 都具有可包含一组触发器的 Triggers 属性。 触发器分为几种类型。

PropertyTrigger

根据属性的值设置属性值或启动操作的 Trigger 称为属性触发器。

若要演示如何使用属性触发器，可以使每个 ListBoxItem 在未选中时部分透明。 以下样式将 ListBoxItem 的 Opacity 值设置为 0.5。 但是，当 IsSelected 属性为 true 时，Opacity 设置为 1.0。

<Window.Resources>
    <!-- .... other resources .... -->

    <Style TargetType="ListBoxItem">
        <Setter Property="Opacity" Value="0.5" />
        <Setter Property="MaxHeight" Value="75" />
        <Style.Triggers>
            <Trigger Property="IsSelected" Value="True">
                <Trigger.Setters>
                    <Setter Property="Opacity" Value="1.0" />
                </Trigger.Setters>
            </Trigger>
        </Style.Triggers>
    </Style>
</Window.Resources>

此示例使用 Trigger 设置属性值，但请注意，Trigger 类还有 EnterActions 和 ExitActions 属性，这些属性可使触发器执行操作。

请注意，ListBoxItem 的 MaxHeight 属性设置为 75。 在下图中，第三项是选中的项。

EventTrigger 和情节提要

另一个触发器类型是 EventTrigger，用于根据某个事件的发生启动一组操作。 例如，以下 EventTrigger 对象指定当鼠标指针进入 ListBoxItem 时，MaxHeight 属性在 0.2 秒的时间内动画化为值 90。 当鼠标离开该项时，属性在 1 秒的时间内返回到原始值。 请注意，不需要为 MouseLeave 动画指定 To 值。 这是因为动画能够跟踪原始值。

<Style.Triggers>
    <Trigger Property="IsSelected" Value="True">
        <Trigger.Setters>
            <Setter Property="Opacity" Value="1.0" />
        </Trigger.Setters>
    </Trigger>
    <EventTrigger RoutedEvent="Mouse.MouseEnter">
        <EventTrigger.Actions>
            <BeginStoryboard>
                <Storyboard>
                    <DoubleAnimation
                        Duration="0:0:0.2"
                        Storyboard.TargetProperty="MaxHeight"
                        To="90"  />
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger.Actions>
    </EventTrigger>
    <EventTrigger RoutedEvent="Mouse.MouseLeave">
        <EventTrigger.Actions>
            <BeginStoryboard>
                <Storyboard>
                    <DoubleAnimation
                        Duration="0:0:1"
                        Storyboard.TargetProperty="MaxHeight"  />
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger.Actions>
    </EventTrigger>
</Style.Triggers>

有关详细信息，请参阅情节提要概述。

在下图中，鼠标指向第三项。

MultiTrigger、DataTrigger 和 MultiDataTrigger

除了 Trigger 和 EventTrigger，还有其他类型的触发器。 MultiTrigger 允许基于多个条件设置属性值。 当条件的属性为数据绑定时，使用 DataTrigger 和 MultiDataTrigger。

视觉状态

控件始终处于特定的状态。 例如，当鼠标在控件的表面上移动时，该控件被视为处于公用状态 MouseOver。 没有特定状态的控件被视为处于公用 Normal 状态。 状态分为多个组，前面提到的状态属于 CommonStates 状态组。 大多数控件都有两个状态组：CommonStates 和 FocusStates。 在应用于控件的每个状态组中，控件始终处于每个组的一种状态，例如 CommonStates.MouseOver 和 FocusStates.Unfocused。 但是，控件不能处于同一组中的两种不同状态，例如 CommonStates.Normal 和 CommonStates.Disabled。 下面是大多数控件可以识别和使用的状态表。

VisualState 名称	VisualStateGroup 名称	说明
普通	CommonStates	默认状态。
MouseOver	CommonStates	鼠标指针悬停在控件上。
Pressed	CommonStates	已按下控件。
已禁用	CommonStates	已禁用控件。
Focused	FocusStates	控件有焦点。
失去焦点	FocusStates	控件没有焦点。

通过在控件模板的根元素上定义 System.Windows.VisualStateManager，可以在控件进入特定状态时触发动画。 VisualStateManager 声明要监视的 VisualStateGroup 和 VisualState 的组合。 当控件进入受监视状态时，将启动 VisualStateManager 定义的动画。

例如，以下 XAML 代码监视 CommonStates.MouseOver 状态，以对名为 backgroundElement 的元素的填充颜色进行动画处理。 当控件恢复为 CommonStates.Normal 状态时，将还原名为 backgroundElement 的元素的填充颜色。

<ControlTemplate x:Key="roundbutton" TargetType="Button">
    <Grid>
        <VisualStateManager.VisualStateGroups>
            <VisualStateGroup Name="CommonStates">
                <VisualState Name="Normal">
                    <ColorAnimation Storyboard.TargetName="backgroundElement"
                                    Storyboard.TargetProperty="(Shape.Fill).(SolidColorBrush.Color)"
                                    To="{TemplateBinding Background}"
                                    Duration="0:0:0.3"/>
                </VisualState>
                <VisualState Name="MouseOver">
                    <ColorAnimation Storyboard.TargetName="backgroundElement"
                                    Storyboard.TargetProperty="(Shape.Fill).(SolidColorBrush.Color)"
                                    To="Yellow"
                                    Duration="0:0:0.3"/>
                </VisualState>
            </VisualStateGroup>
        </VisualStateManager.VisualStateGroups>

        ...

有关情节提要的详细信息，请参阅情节提要概述。

共享资源和主题

典型的 WPF 应用可能具有多个 UI 资源，它们可应用于整个应用。 这组资源统称为应用的主题。 WPF 支持使用封装为 ResourceDictionary 类的资源字典将 UI 资源打包为主题。

WPF 主题通过使用 WPF 公开的样式设置和模板化机制来定义，该机制用于自定义任何元素的视觉对象。

WPF 主题资源存储在嵌入的资源字典中。 这些资源必须嵌入到已签名的程序集内，并且可以嵌入到与代码本身相同的程序集内或并行程序集内。 对于包含 WPF 控件的程序集 PresentationFramework.dll，主题资源位于一系列并行程序集内。

该主题成为在搜索元素样式时最后查看的位置。 通常，搜索先沿着元素树搜索适当的资源，然后在应用资源集合中查找，最后查询系统。 这样一来，应用开发者便有机会在到达主题之前在树或应用级别上为任何对象重新定义样式。

可以将资源字典定义为单独的文件，这些文件支持跨多个应用重复使用主题。 还可以通过定义多个资源字典来创建可交换的主题，这些资源字典以不同的值提供相同类型的资源。 在应用级别上重新定义这些样式或其他资源是设计应用外观的推荐方法。

若要跨应用共享一组资源（包括样式和模板），可创建 XAML 文件，并定义包含对 shared.xaml 文件的引用的 ResourceDictionary。

<ResourceDictionary.MergedDictionaries>
  <ResourceDictionary Source="Shared.xaml" />
</ResourceDictionary.MergedDictionaries>

它是 shared.xaml 的共享，用于定义包含一组样式和画笔资源的 ResourceDictionary，从而使应用中的控件具有一致的外观。

有关详细信息，请参阅合并资源字典。

如果要为自定义控件创建主题，请参阅控件创作概述的在主题级别定义资源部分。

另请参阅

• WPF 中的 Pack URI
• 如何：查找由 ControlTemplate 生成的元素
• 查找由 DataTemplate 生成的元素