模版概述

WPF 模板是实现UI 与逻辑分离、高度自定义界面的核心机制，核心是不修改控件功能，只重定义其外观与数据呈现。

一、模板的核心定位

• 本质：定义控件 / 数据的视觉结构与呈现方式，与控件的业务逻辑（如 Button.Click）完全解耦。
• 核心价值：
  • 彻底自定义控件外观（如圆形按钮、自定义进度条）。
  • 统一数据展示（如列表项、卡片布局）Microsoft Learn。
  • 实现 MVVM 模式，界面与数据分离。
• 基类：所有模板均继承自 FrameworkTemplate。

二、三大核心模板类型

WPF 主要有三种模板，各司其职、配合使用：

1. 控件模板（ControlTemplate）

• 作用：定义单个控件的完整视觉树与外观，替换控件默认样式Microsoft Learn。
• 对应属性：Control.Template。
• 适用场景：
  • 重写 Button、TextBox、CheckBox 等控件的外观。
  • 自定义控件的交互状态（如鼠标悬浮、按下）。
• 关键要点：
  • 必须指定 TargetType（如 Button）。
  • 必须包含 ContentPresenter（内容占位）或 ItemsPresenter（列表项占位），否则控件功能失效。
  • 用 TemplateBinding 绑定控件原有属性（如 Background、IsEnabled）。
• 示例（圆形按钮）：

<ControlTemplate x:Key="RoundButton" TargetType="Button">
    <Border CornerRadius="20" Background="{TemplateBinding Background}"
            BorderBrush="{TemplateBinding BorderBrush}" BorderThickness="2">
        <ContentPresenter HorizontalAlignment="Center" VerticalAlignment="Center"/>
    </Border>
</ControlTemplate>
<!-- 使用 -->
<Button Template="{StaticResource RoundButton}" Content="确定" Background="LightBlue"/>

2. 数据模板（DataTemplate）

• 作用：定义数据对象如何在界面上显示，决定数据的可视化呈现Microsoft Learn。
• 对应属性：
  • 内容控件：ContentControl.ContentTemplate（如 Button、Label）。
  • 列表控件：ItemsControl.ItemTemplate（如 ListBox、ListView、DataGrid）。
• 适用场景：
  • 自定义列表项布局（如用户卡片、商品项）Microsoft Learn。
  • 绑定复杂对象并展示多个属性Microsoft Learn。
• 关键要点：
  • 可通过 DataType 实现隐式应用（无需 x:Key）。
  • 内部直接使用 {Binding} 绑定数据对象属性。
• 示例（用户列表项）：

<DataTemplate DataType="{x:Type local:User}">
    <StackPanel Orientation="Horizontal">
        <Image Source="{Binding Avatar}" Width="40" Height="40"/>
        <TextBlock Text="{Binding Name}" Margin="5"/>
        <TextBlock Text="{Binding Age}" Foreground="Gray"/>
    </StackPanel>
</DataTemplate>
<!-- 自动应用到 ListBox -->
<ListBox ItemsSource="{Binding Users}"/>

3. 面板模板（ItemsPanelTemplate）

• 作用：定义列表控件的子项布局容器（如水平排列、网格布局）。
• 对应属性：ItemsControl.ItemsPanel。
• 适用场景：
  • 改变 ListBox 默认垂直堆叠为水平滚动。
  • 用 WrapPanel、UniformGrid 实现流式布局。
• 示例（水平 ListBox）：

<ListBox>
    <ListBox.ItemsPanel>
        <ItemsPanelTemplate>
            <StackPanel Orientation="Horizontal"/>
        </ItemsPanelTemplate>
    </ListBox.ItemsPanel>
    <ListBoxItem>Item1</ListBoxItem>
    <ListBoxItem>Item2</ListBoxItem>
</ListBox>

三、模板的核心特性与用法

1. 模板与样式（Style）的关系

• Style：批量设置控件属性（如 FontSize、Margin），不改变视觉结构。
• ControlTemplate：重写控件完整视觉树，可在 Style 中通过 Setter 应用。

<Style TargetType="Button">
    <Setter Property="Template" Value="{StaticResource RoundButton}"/>
    <Setter Property="Foreground" Value="White"/>
</Style>

2. 模板绑定（TemplateBinding）

• 用于 ControlTemplate 内部，将模板内元素属性绑定到控件自身属性（如 Background、Content）。
• 是单向、一次性绑定，性能优于普通 Binding。

3. 触发器（Triggers）

• 在模板中用 Trigger、DataTrigger、EventTrigger 实现状态变化（如鼠标悬浮变色、选中高亮）。

<ControlTemplate.Triggers>
    <Trigger Property="IsMouseOver" Value="True">
        <Setter TargetName="border" Property="Background" Value="LightGreen"/>
    </Trigger>
</ControlTemplate.Triggers>

4. 模板的作用域

• 定义在 Resources 中，可在控件、窗口、应用级复用Microsoft Learn。
• 用 x:Key 显式引用，或用 DataType 隐式匹配。

四、模板使用的最佳实践

1. 优先用模板，少写自定义控件：大多数外观需求用 ControlTemplate 即可满足，无需继承控件重写逻辑Microsoft Learn。
2. 分离关注点：
   • ControlTemplate：管控件长什么样。
   • DataTemplate：管数据怎么显示。
   • ItemsPanelTemplate：管子项怎么布局。
3. 保留核心占位元素：ControlTemplate 必须包含 ContentPresenter/ItemsPresenter，否则控件功能异常。
4. 复用与维护：将通用模板定义在应用级资源字典，便于统一修改与维护。

五、三者对比（快速区分）

模板类型	核心作用	对应属性	典型控件
ControlTemplate	控件外观与视觉树	Control.Template	Button、TextBox
DataTemplate	数据对象的呈现	ContentTemplate/ItemTemplate	ListBox、ListView
ItemsPanelTemplate	列表项的布局容器	ItemsControl.ItemsPanel	ListBox、ItemsControl