正确理解ContentPresenter

下图显示继承关系:

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

ContentPresenter:FrameworkElement (ContentPresenter一般用在CT里负责把Control指定的Content显示出来)

Control:FrameworkElement

ItemsControl:Control

ItemsPresenter:FrameworkElement

接著來我們看一下實例:

使用ContentPresenter

            <ContentControl Content="YangMark">
                <ContentControl.Template>
                    <ControlTemplate TargetType="ContentControl">
                        <ContentPresenter/>
                    </ControlTemplate>
                </ContentControl.Template>
            </ContentControl>

輸出結果: YangMark

正確顯示Content!!

不使用ContentPresenter

            <ContentControl Content="YangMark">
                <ContentControl.Template>
                    <ControlTemplate TargetType="ContentControl">
　　　　　　　　　　　　　　<ContentPresenter/>
                    </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"/>
                    </ControlTemplate>
                </ContentControl.Template>
            </ContentControl>

輸出結果:Hello!! YangMark

 

            <ContentControl Content="YangMark" ContentStringFormat="Hello!! {0}">
                <ContentControl.Template>
                    <ControlTemplate TargetType="ContentControl">
                        <ContentPresenter Content="{TemplateBinding Content}"/>
                    </ControlTemplate>
                </ContentControl.Template>
            </ContentControl>

輸出結果:YangMark

僅出現Content屬性的內容!!

結論2:<ContentPresenter/>與<ContentPresenter ContentSource="Content"/> 意義上是相同的。

写ContentSource它們同時綁定了Content, ContentStringFormat, ContentTemplate和ContentTemplateSelector等內容

若僅用Content="{TemplateBinding Content}"代表只綁定Content屬性而已，还要手动绑定其他ContentStringFormat, ContentTemplate和ContentTemplateSelector等。

實例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聲明指定的對象.

參考資料:

比如使用ContentPresenter的ContentSource，然后在ContentControl中设置ContentStringFormat：

<Window.Resources>

    <Style TargetType="ContentControl">

        <Setter Property="Template">

            <Setter.Value>

                <ControlTemplate TargetType="ContentControl">

                    <!-- 这里等价于直接<ContentPresenter /> -->

                    <!-- 强调一下直接用ContentPresenter其ContentSource属性为Content -->

                    <ContentPresenter ContentSource="Content"/>

                </ControlTemplate>

            </Setter.Value>

        </Setter>

    </Style>

</Window.Resources>

<ContentControl ContentStringFormat="你好：{0}">Mgen</ContentControl>

结果会输出：你好：Mgen。

如果把上面ContentPresenter改用TemplateBinding绑定ContentControl的Content属性：

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

结果只会输出：Mgen。

此时其实ContentStringFormat，ContentTemplate和ContentTemplateSelector都不会管用的，那么只能再用TemplateBinding都把他们在ContentPresenter中绑定好：

<ContentPresenter Content="{TemplateBinding Content}"

                 ContentStringFormat="{TemplateBinding ContentStringFormat}"

                 ContentTemplate="{TemplateBinding ContentTemplate}"

                 ContentTemplateSelector="{TemplateBinding ContentTemplateSelector}"/>

当然ContentPresenter不仅限于ContentControl，可以用在任何类似ContentControl.Content这样的控件属性中，比如HeaderedContentControl.Header属性。

这样定义HeaderedContentControl的控件模板：

<Style TargetType="HeaderedContentControl">

    <Setter Property="Template">

        <Setter.Value>

            <ControlTemplate TargetType="HeaderedContentControl">

                <DockPanel>

                    <Border DockPanel.Dock="Top">

                        <ContentPresenter ContentSource="Header"/>

                    </Border>

                    <!-- 等于：<ContentPresenter ContentSource="Content"/> -->

                    <ContentPresenter/>

                </DockPanel>

            </ControlTemplate>

        </Setter.Value>

    </Setter>

</Style>

示例：

<HeaderedContentControl Header="Header"

                       Content="Content"

                       HeaderStringFormat="上：{0}"

                       ContentStringFormat="下：{0}"/>

结果：

如果用Content来绑定Header属性：

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

那么你还得再次绑定ContentStringFormat，ContentTemplate和ContentTemplateSelector属性，所以记住总是用ContentPresenter.ContentSource属性。

WPF：为什么使用ContentPresenter.ContentSource而不是Content属性？

wpf控件开发基础(1)

转WPF的Presenter(ContentPresenter)