WPF 控件【U】ContentControl(一) ContentControl使用ContentPresenter显示content内容

最新推荐文章于 2026-04-05 09:47:52 发布

原创最新推荐文章于 2026-04-05 09:47:52 发布 · 5.8k 阅读

7 ·

本内容遵循CC 4.0 BY-SA版权协议

---------- 【控件+自定义控件】专栏收录该内容

20 篇文章

订阅专栏

本文详细介绍了WPF中ContentControl的使用方法及其与ContentPresenter的关系。通过实例展示了如何利用ContentPresenter和ContentSource属性正确显示内容，并总结了它们在控件模板中的关键作用。

第一章、简介

转载https://www.cnblogs.com/YangMark/p/3172725.html

本文介绍ContentControl使用，其需要结合ContentPresenter、ContentSource这两个属性来显示内容。

我們先由下圖來看類層次,可知ContentControl繼承Control,ContentPresenter繼承FrameworkElement(Control也繼承FrameworkElement)。

同樣的,ItemsControl繼承Control,ItemsPresenter繼承FrameworkElement。

在Control類並沒有Content屬性, 所以在這之上再寫了一個ContentControl, 使控件有Content屬性可以顯示內容, 而

ContentPresenter就是負責將Content屬性顯示出來.

第二章、应用举例

實例1:不使用ContentPresenter

使用ContentPresenter <ContentControl Content="YangMark">

<ContentControl.Template>

<ControlTemplate TargetType="ContentControl"> <ContentPresenter></ContentPresenter> </ControlTemplate> </ContentControl.Template> </ContentControl>
輸出結果: YangMark
正確顯示Content!!
不使用ContentPresenter
<ContentControl Content="YangMark"> <ContentControl.Template> <ControlTemplate TargetType="ContentControl"> </ControlTemplate> </ContentControl.Template> </ContentControl>
輸出結果:
無法顯示出Content!!
結論1:ContentPresenter通常出現在ControlTemplate內,且若不使用ContentPresenter則 Content屬性就無法正常顯示。

實例2:ContentPresenter中的ContentSource屬性
為什麼只為了顯示出Content屬性要大費周張弄出ContentPresenter呢??我們可以先比較以下兩種代碼不同之類,
<ContentControl Content="YangMark" ContentStringFormat="Hello!! {0}"> <ContentControl.Template> <ControlTemplate TargetType="ContentControl"> <ContentPresenter ContentSource="Content"></ContentPresenter> </ControlTemplate> </ContentControl.Template> </ContentControl>

輸出結果:Hello!! YangMark

            <ContentControl Content="YangMark" ContentStringFormat="Hello!! {0}">
                <ContentControl.Template>
                    <ControlTemplate TargetType="ContentControl">
                        <ContentPresenter Content="{TemplateBinding Content}"></ContentPresenter>
                    </ControlTemplate>
                </ContentControl.Template>
            </ContentControl>
輸出結果:YangMark
僅出現Content屬性的內容!!
結論2:<ContentPresenter/>與<ContentPresenter ContentSource="Content"/> 意義上是相同的。  
        
    它們同時綁定了Content, ContentStringFormat, ContentTemplate和ContentTemplateSelector等內容屬性。若僅用Content="{TemplateBinding Content}"代表只綁定Content屬性而已，且ContentSource會失效。

實例3:ContentSource的應用
 以HeaderContentControl為例,使用ContentPresenter綁定內容屬性。            
          <HeaderedContentControl Header="Header" HeaderStringFormat="I'm {0}"
                                  Content="Content" ContentStringFormat="I'm {0}">
                <HeaderedContentControl.Template>
                    <ControlTemplate TargetType="HeaderedContentControl">
                        <DockPanel>
                            <ContentPresenter ContentSource="Header" DockPanel.Dock="Top"></ContentPresenter>
                            <!--等同於<ContentPresenter ContentSource="Content"/>-->
                            <ContentPresenter></ContentPresenter>
                        </DockPanel>
                    </ControlTemplate>
                </HeaderedContentControl.Template>
            </HeaderedContentControl>

輸出結果：

I'm Header

I’m Content

結論3:ContentSource若指定對象為Content是可以省略的,若不為Content(如:Header)則不能省略。

總結：

Content, ContentStringFormat, ContentTemplate和ContentTemplateSelector等屬性, 我將它們稱為內容屬性.

1. ContentPresenter的作用就是用來顯示內容屬性

2.ContentSource若指定對象為Content,則等同於<ContentPresenter/>; 若指定對象不為Content,

則必須使用ContentSource聲明指定的對象.