WPF ContentPresenter详解2

ContentPresenter与ContentControl的区别

ContentControl 和 ContentPresenter 是 WPF 中两个相关的控件，但它们在用途和功能上有一些关键的区别。理解这两者的区别和联系有助于更好地设计和开发用户界面。

1. 类层次结构

• ContentControl：位于 WPF 控件层次结构中较高的位置，继承自 Control 类。它是一个可以直接使用的控件，旨在容纳和展示单一内容。

  继承链如下：

  ContentControl : Control : FrameworkElement : UIElement : Visual : DispatcherObject
  

• ContentPresenter：并不是一个控件，而是一个轻量级的元素，主要用于模板（如 ControlTemplate）内部，作为内容的占位符。它不继承自 Control，而是直接继承自 FrameworkElement。

  继承链如下：

  ContentPresenter : FrameworkElement : UIElement : Visual : DispatcherObject
  

2. 基本概念

• ContentControl：这是一个基础控件，用于显示单一的内容。它可以容纳任何类型的内容（文本、图形、UI 元素或其他数据类型），并且支持通过 ContentTemplate 和 ContentTemplateSelector 来定义如何呈现这些内容。很多其他控件（如 Button、Label 等）都是直接或间接地继承自 ContentControl。

• ContentPresenter：通常用于 ControlTemplate 内部，作为内容的占位符。它的主要作用是在模板中展示 ContentControl 或其他具有 Content 属性的控件的内容。它更轻量级，主要用于实现模板逻辑，而不是作为一个独立的控件使用。

3. 主要区别

3.1 用途不同

• ContentControl：是一个完整的控件，可以独立存在，并拥有自己的属性集（例如 Foreground、Background 等）。它通常用于需要直接包含内容并提供额外功能（如焦点管理）的情况。
• ContentPresenter：主要用于 ControlTemplate 内部，作为占位符来展示内容。它依赖于外部的模板定义，并且通常不提供额外的样式或功能。

3.2 使用场景

• ContentControl：当你需要一个可以直接添加到 UI 中的控件，并希望该控件能够灵活地展示不同类型的内容时，可以使用 ContentControl。
• ContentPresenter：当你正在设计一个自定义控件的模板，并需要一种方式来指定模板中内容的位置时，使用 ContentPresenter。

3.3 自定义能力

• ContentControl 提供了更多的属性来定制外观和行为，比如可以通过设置 ContentTemplate 或 ContentTemplateSelector 来控制内容的显示方式。
• **`ContentPresenter`` 更加专注于内容的展示，特别是在模板上下文中，其主要职责是根据模板规则展示内容。

3.4 功能与用途

1. ContentControl

• 功能：ContentControl 是一个可以容纳任何类型内容的控件，支持通过 ContentTemplate 和 ContentTemplateSelector 来定义如何呈现内容。它提供了一系列属性（例如 Foreground、Background 等），使得它可以作为一个独立的控件使用。

• 用途：适用于需要展示单一内容的场景。许多其他控件（如 Button、Label、CheckBox 等）都是 ContentControl 的子类或间接继承自 ContentControl。

• 显示外观和内容：ContentControl 是一个完整的控件，它不仅能够显示内容（通过 Content 属性），还可以定义外观（如背景色、边框等）。

• 事件触发能力：ContentControl 通常支持用户交互（如点击、焦点管理等），并且可以通过事件处理程序响应这些交互。

• 灵活性：通过 ContentTemplate 和 ContentTemplateSelector，它可以灵活地控制内容的呈现方式。

2. ContentPresenter

• 功能：ContentPresenter 主要用于在 ControlTemplate 内部工作，作为一个占位符来展示内容。它可以根据模板规则自动显示 ContentControl 或其他具有 Content 属性的控件的内容。

• 用途：当设计自定义控件时，在 ControlTemplate 中使用 ContentPresenter 来指定内容应该在哪里显示。这允许模板更加灵活，能够以不同的方式展示内容，而不需要修改 ContentControl 的逻辑。

• 专注于内容展示：ContentPresenter 是一个轻量级的元素，专门用于在控件模板中作为占位符，展示内容。

• 自动绑定到 ContentControl 的属性：当 ContentPresenter 被嵌入到 ContentControl 的 ControlTemplate 中时，它会通过 TemplateBinding 或其他绑定机制，自动绑定到 ContentControl 的 Content 属性以及相关的模板属性（如 ContentTemplate）。

• 解耦设计：它的职责仅限于展示内容，而不涉及内容管理或控件逻辑。这种设计使得 ContentPresenter 更加高效且易于使用。

4. 关系与协作

尽管 ContentControl 和 ContentPresenter 在用途上有显著的区别，但它们也经常一起工作：

• 在为 ContentControl 创建 ControlTemplate 时，通常会在模板内部使用 ContentPresenter 来显示 ContentControl 的内容。这是因为 ContentPresenter 能够根据模板中的设置（如 ContentTemplate）动态地呈现内容。

例如，以下是一个简单的按钮模板示例，其中使用了 ContentPresenter 来显示按钮的内容：

• 当你为一个 ContentControl 创建 ControlTemplate 时，通常会在模板内部使用 ContentPresenter 来指定内容应该在哪里显示。这样做的好处是可以让你的控件模板更加灵活，允许内容以不同的方式被展示，而不需要修改 ContentControl 的逻辑。

代码示例1

例如，在一个自定义按钮的 ControlTemplate 中，你可以这样做：

<ControlTemplate TargetType="Button">
    <Border Background="{TemplateBinding Background}"
            BorderBrush="{TemplateBinding BorderBrush}"
            BorderThickness="{TemplateBinding BorderThickness}">
        <!-- 使用 ContentPresenter 显示按钮的内容 -->
        <ContentPresenter HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                          VerticalAlignment="{TemplateBinding VerticalContentAlignment}" />
    </Border>
</ControlTemplate>

在这个例子中，ContentPresenter 被用来展示 Button 控件的内容，而这个 Button 控件本身就是一个 ContentControl 的实例。

代码示例2

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Custom ContentControl Example" Height="350" Width="525">
    <Window.Resources>
        <!-- 自定义 ControlTemplate -->
        <ControlTemplate x:Key="CustomContentControlTemplate" TargetType="ContentControl">
            <Border Background="LightBlue" BorderBrush="Black" BorderThickness="2" CornerRadius="10">
                <Grid>
                    <!-- 使用 ContentPresenter 显示内容 -->
                    <ContentPresenter Content="{TemplateBinding Content}"
                                      ContentTemplate="{TemplateBinding ContentTemplate}" />
                </Grid>
            </Border>
        </ControlTemplate>
    </Window.Resources>
    <Grid>
        <!-- 使用自定义模板的 ContentControl -->
        <ContentControl Template="{StaticResource CustomContentControlTemplate}"
                        Content="Hello, World!"
                        HorizontalAlignment="Center"
                        VerticalAlignment="Center" />
    </Grid>
</Window>

运行效果

• 在这个例子中：
  • ContentControl 使用了一个自定义的 ControlTemplate。
  • 在模板中，ContentPresenter 被用来显示 ContentControl 的内容。
  • ContentPresenter 通过 TemplateBinding 绑定了 ContentControl 的 Content 属性，因此它能够正确地显示 "Hello, World!"。

是的，当你在控件模板（ControlTemplate）中直接使用 <ContentPresenter /> 时，它会自动绑定到该模板所应用的控件的 Content 属性。这是 WPF 的默认行为，因为 ContentPresenter 专为展示内容而设计，并且它会隐式地绑定到模板的目标控件的相关属性。

5. 默认绑定机制

当 ContentPresenter 被放置在一个 ControlTemplate 中时，WPF 会自动执行以下默认绑定：

• ContentPresenter.Content 绑定到目标控件的 Content 属性。
• ContentPresenter.ContentTemplate 绑定到目标控件的 ContentTemplate 属性。
• ContentPresenter.ContentTemplateSelector 绑定到目标控件的 ContentTemplateSelector 属性。

因此，即使你只写了 <ContentPresenter />，它也会自动找到目标控件的 Content 属性并显示其内容。

5.1. 示例代码

以下是一个完整的示例，展示了如何使用 <ContentPresenter /> 自动绑定到 ContentControl 的 Content 属性：

XAML 示例

<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>
        <!-- 自定义 ContentControl 的 ControlTemplate -->
        <ControlTemplate x:Key="CustomContentControlTemplate" TargetType="ContentControl">
            <Border Background="LightGray" BorderBrush="Black" BorderThickness="2" CornerRadius="10">
                <Grid>
                    <!-- ContentPresenter 会自动绑定到 ContentControl 的 Content 属性 -->
                    <ContentPresenter />
                </Grid>
            </Border>
        </ControlTemplate>
    </Window.Resources>
    <Grid>
        <!-- 使用自定义模板的 ContentControl -->
        <ContentControl Template="{StaticResource CustomContentControlTemplate}"
                        Content="Hello, World!"
                        HorizontalAlignment="Center"
                        VerticalAlignment="Center" />
    </Grid>
</Window>

运行效果

• 在这个例子中，ContentControl 的 Content 属性被设置为 "Hello, World!"。
• 在自定义的 ControlTemplate 中，<ContentPresenter /> 自动绑定了 ContentControl 的 Content 属性，并将其内容显示出来。

关键点

• 无需显式绑定：<ContentPresenter /> 不需要手动指定 Content="{TemplateBinding Content}"，因为这是它的默认行为。
• 自动继承上下文：ContentPresenter 会自动从模板的目标控件继承 Content、ContentTemplate 和其他相关属性。

5.2. 默认绑定的工作原理

WPF 的模板系统会根据 ControlTemplate 的 TargetType 来推断目标控件的类型，并将 ContentPresenter 的属性与目标控件的相应属性绑定起来。以下是具体的绑定逻辑：

1. ContentPresenter.Content：
   • 默认绑定到目标控件的 Content 属性。
2. ContentPresenter.ContentTemplate：
   • 默认绑定到目标控件的 ContentTemplate 属性。
3. ContentPresenter.ContentTemplateSelector：
   • 默认绑定到目标控件的 ContentTemplateSelector 属性。

这些默认绑定使得 ContentPresenter 能够无缝地展示目标控件的内容，而无需开发者显式地编写绑定代码。

5.3. 显式绑定的情况

虽然 <ContentPresenter /> 已经足够满足大多数场景的需求，但在某些情况下，你可能需要显式地指定绑定关系。例如：

显式绑定的示例

<ContentPresenter Content="{TemplateBinding Content}"
                  ContentTemplate="{TemplateBinding ContentTemplate}" />

这种写法与默认行为完全一致，但它更明确地表达了绑定逻辑。通常在以下情况下会使用显式绑定：

• 你需要覆盖默认行为。
• 你希望更好地控制绑定逻辑（例如，添加转换器或更改绑定路径）。

6. 总结

• ContentControl 是一个通用的控件，可以容纳和展示各种类型的内容，并且支持高度的定制化。
• ContentPresenter 则更多地用于 ControlTemplate 中，作为一个占位符来展示内容，它是实现模板逻辑的重要工具。
• 尽管它们的功能有所不同，但在实际应用中，ContentPresenter 往往会被嵌入到 ContentControl 的模板中，共同完成复杂的用户界面设计任务。

在 WPF 中，ContentControl 和 ContentPresenter 都是用于内容展示的重要控件，但它们之间并没有直接的继承关系。相反，它们各自扮演着不同的角色，并且通常一起使用来实现灵活的内容展示。下面详细介绍它们之间的关系以及各自的特性。

ContentControl 是一种能够显示外观包括内容且有一定事件触发能力的控件，当我想要重写对应这种控件或者继承这类控件的类时， ContentPresenter在其中就可以作为一个内容显示的部分自动绑定到对应ContentControl 这类控件的Content属性上，从而实现内容的显示。

参考链接

ContentPresenter
ContenPresenter
经典