ContentPresenter 是 WPF 中一个非常重要的控件，它通常用于 ControlTemplate 内部，负责显示控件的内容。它的主要作用是将控件的 Content 属性（或通过数据绑定传递的内容）呈现出来。以下是关于 ContentPresenter 的详细讲解，包括其定义、属性、使用场景以及示例。
1. 定义
ContentPresenter 是一个轻量级的控件，主要用于在 ControlTemplate 中显示内容。它是一个占位符，能够根据模板中定义的逻辑来呈现控件的内容。它可以处理文本、图形、UI 元素等不同类型的内容。
关键特性
- 自动内容呈现：
ContentPresenter会自动识别并呈现控件的Content属性。 - 样式和模板支持：可以通过设置
ContentTemplate或ContentTemplateSelector来指定如何呈现内容。 - 灵活性：可以与
DataTemplate结合使用，实现复杂的数据绑定和显示逻辑。
2. 属性
ContentPresenter 提供了多个属性，允许你自定义内容的显示方式。
2.1 基本属性
Content：获取或设置要呈现的内容。如果未显式设置，ContentPresenter会尝试从模板的目标控件中获取Content属性。ContentSource：指定要使用的属性名（例如Header或Content），而不是默认的Content属性。ContentTemplate：获取或设置用于呈现Content的数据模板。ContentTemplateSelector：获取或设置用于选择Content数据模板的选择器。
2.2 布局属性
HorizontalAlignment和VerticalAlignment：控制内容在其容器中的水平和垂直对齐方式。Margin：为内容添加外边距。Padding：为内容添加内边距。
2.3 其他属性
RecognizesAccessKey：指示ContentPresenter是否应识别访问键（快捷键）。默认值为true。Focusable：指示是否可以通过键盘导航聚焦到该元素。默认值为false。
3. 使用场景
3.1 在 ControlTemplate 中使用
ContentPresenter 最常见的用途是在 ControlTemplate 中，用于显示控件的内容。例如，当你自定义按钮的外观时，可以使用 ContentPresenter 来显示按钮上的文本或图标。
示例：自定义按钮
<Window x:Class="WpfApp.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="ContentPresenter Example" Height="350" Width="525">
<Window.Resources>
<!-- 自定义按钮模板 -->
<ControlTemplate x:Key="CustomButtonTemplate" TargetType="Button">
<Border Background="{TemplateBinding Background}"
BorderBrush="{TemplateBinding BorderBrush}"
BorderThickness="{TemplateBinding BorderThickness}"
CornerRadius="5">
<!-- 使用 ContentPresenter 显示按钮的内容 -->
<ContentPresenter HorizontalAlignment="Center" VerticalAlignment="Center" />
</Border>
</ControlTemplate>
</Window.Resources>
<Grid>
<Button Template="{StaticResource CustomButtonTemplate}"
Content="Click Me"
Background="LightBlue"
BorderBrush="DarkBlue"
BorderThickness="2"
Width="100"
Height="40"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
</Grid>
</Window>
3.2 使用 DataTemplate
ContentPresenter 可以与 DataTemplate 结合使用，以更灵活的方式呈现内容。这对于需要动态生成 UI 元素的场景非常有用。
示例：结合 DataTemplate
假设我们有一个简单的数据类 Person：
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
然后，在 XAML 中使用 ContentPresenter 和 DataTemplate：
<Window x:Class="WpfApp.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:WpfApp"
Title="ContentPresenter with DataTemplate Example" Height="350" Width="525">
<Window.Resources>
<!-- 定义 DataTemplate -->
<DataTemplate DataType="{x:Type local:Person}">
<StackPanel Orientation="Horizontal">
<TextBlock Text="{Binding Name}" FontWeight="Bold" />
<TextBlock Text=", " />
<TextBlock Text="{Binding Age}" FontStyle="Italic" />
</StackPanel>
</DataTemplate>
</Window.Resources>
<Grid>
<!-- 使用 ContentPresenter 显示 Person 对象 -->
<ContentControl Content="{Binding}" HorizontalAlignment="Center" VerticalAlignment="Center">
<ContentControl.ContentTemplate>
<DataTemplate>
<ContentPresenter />
</DataTemplate>
</ContentControl.ContentTemplate>
</ContentControl>
</Grid>
</Window>
在这个例子中：
ContentPresenter被嵌套在ContentControl的ContentTemplate中。- 当
ContentControl的Content属性被设置为一个Person对象时，ContentPresenter会自动应用匹配的DataTemplate。
3.3 动态选择 DataTemplate
有时，你需要根据不同的条件选择不同的 DataTemplate。这时可以使用 ContentTemplateSelector。
示例：使用 ContentTemplateSelector
首先，定义一个自定义的 DataTemplateSelector：
public class PersonTemplateSelector : DataTemplateSelector
{
public DataTemplate AdultTemplate { get; set; }
public DataTemplate ChildTemplate { get; set; }
public override DataTemplate SelectTemplate(object item, DependencyObject container)
{
if (item is Person person)
{
return person.Age >= 18 ? AdultTemplate : ChildTemplate;
}
return null;
}
}
然后，在 XAML 中使用这个选择器：
<Window.Resources>
<!-- 定义两个 DataTemplate -->
<DataTemplate x:Key="AdultTemplate">
<TextBlock Text="{Binding Name}" Foreground="Blue" />
</DataTemplate>
<DataTemplate x:Key="ChildTemplate">
<TextBlock Text="{Binding Name}" Foreground="Red" />
</DataTemplate>
<!-- 定义 DataTemplateSelector -->
<local:PersonTemplateSelector x:Key="PersonTemplateSelector"
AdultTemplate="{StaticResource AdultTemplate}"
ChildTemplate="{StaticResource ChildTemplate}" />
</Window.Resources>
<!-- 使用 ContentPresenter 和 DataTemplateSelector -->
<ContentControl Content="{Binding}" HorizontalAlignment="Center" VerticalAlignment="Center"
ContentTemplateSelector="{StaticResource PersonTemplateSelector}">
<ContentControl.ContentTemplate>
<DataTemplate>
<ContentPresenter />
</DataTemplate>
</ContentControl.ContentTemplate>
</ContentControl>
4. 关键点总结
4.1 ContentPresenter vs ContentControl
ContentPresenter：主要用于ControlTemplate内部，作为内容的占位符。它更加轻量，通常不需要额外的样式或模板。ContentControl：是一个完整的控件，可以包含任意类型的内容，并且支持更多的属性（如ContentTemplate和ContentTemplateSelector）。ContentControl内部通常使用ContentPresenter来显示内容。
4.2 TemplateBinding
在 ControlTemplate 中，经常使用 TemplateBinding 将 ContentPresenter 的属性绑定到控件的属性。例如：
<ContentPresenter HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
VerticalAlignment="{TemplateBinding VerticalContentAlignment}" />
4.3 ContentSource 属性
ContentSource 属性允许你指定要使用的属性名（不仅仅是 Content）。例如，如果你正在设计一个 HeaderedContentControl，你可以使用 ContentSource="Header" 来显示 Header 属性的内容。
4.4 RecognizesAccessKey
如果你希望 ContentPresenter 支持访问键（快捷键），可以设置 RecognizesAccessKey="True"。这在某些情况下（如菜单项）非常有用。
5. 总结
ContentPresenter是一个用于在ControlTemplate中显示内容的关键控件。- 它可以与
DataTemplate结合使用，实现复杂的数据绑定和显示逻辑。 - 通过
ContentTemplate和ContentTemplateSelector，可以灵活地选择和应用不同的数据模板。 - 在实际开发中，
ContentPresenter经常与ControlTemplate和ContentControl配合使用，以创建高度定制化的用户界面。
通过合理使用 ContentPresenter，你可以构建出功能强大且外观精美的 WPF 应用程序。