TemplatePartAttribute

在学习ControlTemplate示例时，发现有一些template中元素名称以PART_开头，在《Windows Presentation Foundation Unleashed》中也提到了。

在WPF自带的templdate中有很多以PART_开头的元素，这些元素都是用TemplatePartAttribute标记过，表示如果用户想自定义模版，必须提供同名及同类型的元素。原因是WPF自带的控件后台逻辑会与这些元素交互，比如ProgressBar中的进度条长度，这个是动态的，由后台代码指定的，再比如ComboBox，下拉列表，这个是Popup元素构成的，我们在实现template时，也有一定包含同名的Popup元素，也就是PART_Popup。周银辉的文章写的挺好。

如果不提供同名，同类型的元素，那就需要自己处理相关的逻辑，需要额外的工作量。比如《Windows Presentation Foundation Unleashed》中实现的圆形的ProgressBar。

《Windows Presentation Foundation Unleashed》中提到的PART_打头的控件：
ProgressBar中的PART_Indicator和PART_Track，用来保证进度条能正确的显示当前进度。

<ResourceDictionary 

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >



  <ResourceDictionary.MergedDictionaries>

    <ResourceDictionary Source="Shared.xaml" />

  </ResourceDictionary.MergedDictionaries>



  <!-- SimpleStyles: ProgressBar -->

  <!--<SnippetProgressBar>-->

    <!--Background="{StaticResource PressedBrush}"-->

    <!--Background="{StaticResource DarkBrush}"-->

    <Style x:Key="{x:Type ProgressBar}"

       TargetType="{x:Type ProgressBar}">

    <Setter Property="Template">

      <Setter.Value>

        <ControlTemplate TargetType="{x:Type ProgressBar}">

          <Grid MinHeight="14" MinWidth="200">

            <Border 

              Name="PART_Track" 

              CornerRadius="2" 

              

              Background ="Blue"

              BorderBrush="{StaticResource SolidBorderBrush}"

              BorderThickness="1" />

            <Border 

              Name="PART_Indicator" 

              CornerRadius="2" 

              Background="Red"

              BorderBrush="{StaticResource NormalBorderBrush}" 

              BorderThickness="1" 

              HorizontalAlignment="Left" />

          </Grid>

        </ControlTemplate>

      </Setter.Value>

    </Setter>

  </Style>

  <!--</SnippetProgressBar>-->

</ResourceDictionary>

 

ComboBox中Popup元素名为PART_Popup,使得ComboBox的DropDownClosed事件能正常响应。为名PART_EditableTextBox的是TextBox，允许用户输入。

TextBox中必须有一个名为PART_ContentHost的元素，类型为ScrollViewer 或 AdornerDecorator。

有哪些内部定义的元素被指定了TemplatePartAtrribute呢，可以在WPF Control库中查到，比如ProgressBar：
定义如下：
[TemplatePartAttribute(Name = "PART_Track", Type = typeof(FrameworkElement))]
[TemplatePartAttribute(Name = "PART_Indicator", Type = typeof(FrameworkElement))]
public class ProgressBar : RangeBase

MSDN上的ControlTemplate示例也是很好的学习参考。