Control.Template 属性

public:
 property ControlTemplate ^ Template { ControlTemplate ^ get(); void set(ControlTemplate ^ value); };

ControlTemplate Template();

void Template(ControlTemplate value);

public ControlTemplate Template { get; set; }

var controlTemplate = control.template;
control.template = controlTemplate;

Public Property Template As ControlTemplate

<control Template="{StaticResource templateResourceKey}"/>
- or -
<Style TargetType="controlTypeName">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="controlTypeName">
        templateRoot
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

属性值

定义 控件外观的模板。 ControlTemplate 必须恰好有一个根元素作为其内容。

示例

此示例演示了一个更完整的控件模板，该模板定义为 Style 和 Setter ，其 Setter.属性值 为“Template”。 这是 RadioButton 控件的命名样式。 它包括通常属于功能控件模板的模板元素，例如 VisualStateManager.VisualStateGroups 附加到模板根元素的附加属性元素，以及分配给每个突出控件部件的 x：Name 属性值 。

<Style x:Key="TextRadioButtonStyle" TargetType="RadioButton"> 
    <Setter Property="MinWidth" Value="0"/> 
    <Setter Property="MinHeight" Value="0"/> 
    <Setter Property="Template"> 
        <Setter.Value> 
            <ControlTemplate TargetType="RadioButton"> 
                <Grid Background="Transparent"> 
                    <TextBlock 
                        x:Name="Text" 
                        Text="{TemplateBinding Content}" 
                        Margin="3,-7,3,10" 
                        TextWrapping="NoWrap" 
                        Style="{StaticResource SubheaderTextStyle}"/> 
                    <Rectangle 
                        x:Name="FocusVisualWhite" 
                        IsHitTestVisible="False" 
                        Stroke="{StaticResource FocusVisualWhiteStrokeThemeBrush}" 
                        StrokeEndLineCap="Square" 
                        StrokeDashArray="1,1" 
                        Opacity="0" 
                        StrokeDashOffset="1.5"/> 
                    <Rectangle 
                        x:Name="FocusVisualBlack" 
                        IsHitTestVisible="False" 
                        Stroke="{StaticResource FocusVisualBlackStrokeThemeBrush}" 
                        StrokeEndLineCap="Square" 
                        StrokeDashArray="1,1" 
                        Opacity="0" 
                        StrokeDashOffset="0.5"/> 

                    <VisualStateManager.VisualStateGroups> 
                        <VisualStateGroup x:Name="CommonStates"> 
                            <VisualState x:Name="Normal"/> 
                            <VisualState x:Name="PointerOver"> 
                                <Storyboard> 
                                    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="Text" Storyboard.TargetProperty="Foreground"> 
                                        <DiscreteObjectKeyFrame KeyTime="0" Value="{StaticResource ApplicationPointerOverForegroundThemeBrush}"/> 
                                    </ObjectAnimationUsingKeyFrames> 
                                </Storyboard> 
                            </VisualState> 
                            <VisualState x:Name="Pressed"> 

                                <Storyboard> 
                                    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="Text" Storyboard.TargetProperty="Foreground"> 
                                        <DiscreteObjectKeyFrame KeyTime="0" Value="{StaticResource ApplicationPressedForegroundThemeBrush}"/> 
                                    </ObjectAnimationUsingKeyFrames> 
                                </Storyboard> 
                            </VisualState> 
                            <VisualState x:Name="Disabled"> 
                                <Storyboard> 
                                    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="Text" Storyboard.TargetProperty="Foreground"> 
                                        <DiscreteObjectKeyFrame KeyTime="0" Value="{StaticResource ButtonDisabledForegroundThemeBrush}"/> 
                                    </ObjectAnimationUsingKeyFrames> 
                                </Storyboard> 
                            </VisualState> 
                        </VisualStateGroup> 
                        <VisualStateGroup x:Name="FocusStates"> 
                            <VisualState x:Name="Focused"> 
                                <Storyboard> 
                                    <DoubleAnimation Duration="0" To="1" Storyboard.TargetName="FocusVisualWhite" Storyboard.TargetProperty="Opacity"/> 
                                    <DoubleAnimation Duration="0" To="1" Storyboard.TargetName="FocusVisualBlack" Storyboard.TargetProperty="Opacity"/> 
                                </Storyboard> 
                            </VisualState> 
                            <VisualState x:Name="Unfocused"/> 
                        </VisualStateGroup> 
                        <VisualStateGroup x:Name="CheckStates"> 
                            <VisualState x:Name="Checked"/> 
                            <VisualState x:Name="Unchecked"> 
                                <Storyboard> 
                                    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="Text" Storyboard.TargetProperty="Foreground"> 
                                        <DiscreteObjectKeyFrame KeyTime="0" Value="{StaticResource ApplicationSecondaryForegroundThemeBrush}"/> 
                                    </ObjectAnimationUsingKeyFrames> 
                                </Storyboard> 
                            </VisualState> 
                            <VisualState x:Name="Indeterminate"/> 
                        </VisualStateGroup> 
                    </VisualStateManager.VisualStateGroups> 
                </Grid> 
            </ControlTemplate> 
        </Setter.Value> 
    </Setter> 
</Style> 

注解

上面显示的第二个 XAML 语法是作为 Style 的一部分的 Setter 语法。 在几乎所有情况下，控件的模板值都是这样定义的。

TargetType 是用作模板值的所有 ControlTemplate 元素的必需属性。 如果使用 style-setter 语法，则该值应与包含 Setter for Template 的 Style 的 TargetType 属性匹配。

ControlTemplate 指定控件的外观;如果控件没有 ControlTemplate，则控件在你的应用中将没有可见状态。 控件作者定义默认控件模板，应用作者可以重新创建 ControlTemplate XAML 模板，以重新定义控件的可视树。

控件 模板通常在可扩展应用程序标记语言 (XAML) 中设置，作为特定于控件的隐式样式的一部分。 在这种情况下，Setter 中的属性值设置为字符串“Template”，Setter.Value 值设置为属性元素，其中包含 ControlTemplate 对象元素。 例如，这是为 ScrollViewer 定义模板值的 Style。 这是隐式样式的示例，其中 Style 可以位于 ResourceDictionary 中，但不需要 x：Key 属性。

<ResourceDictionary>
  <Style TargetType="ScrollViewer">
  ...
    <Setter Property="Template">
      <Setter.Value>
        <ControlTemplate TargetType="ScrollViewer">
          <!--visual root of template for a ScrollViewer-->
        </ControlTemplate>
      </Setter.Value>
    </Setter>
  </Style>
  ...
</ResourceDictionary>

样式和模板

可以使用 Style 中的 Setter 将值应用于任何依赖属性。 但是，它是控件派生类的 Template 属性的 Setter，它构成了典型 Style 中的大多数 XAML 标记。 使用 Style 定义控件模板时，Style 元素的 TargetType 及其 Control.Template setter 的 ControlTemplate 元素的 TargetType 应始终使用相同的值。 模板设置程序为应用该模板的控件定义基本的模板化 UI 定义。 它还包含控件的视觉状态以及其他基于状态的 UI 定义，例如默认主题切换。 对于复杂控件（如 ListBox），默认模板 Style 和中的 ControlTemplate 可以包含数百行 XAML。 有关模板在控件模板化方案中的角色的详细信息，请参阅 XAML 控件模板。

隐式样式

可以定义样式，使同一 TargetType 的所有对象隐式使用 Style，而无需此类对象的每个实例专门引用 Style 作为 FrameworkElement.Style 值。 <Style>在没有 x：Key 属性的 ResourceDictionary 中声明资源时，x：Key 值使用 TargetType 属性的值。 如果隐式设置样式，则样式仅应用于与 TargetType 完全匹配的类型，而不应用于派生自 TargetType 值的元素。 例如，如果为应用程序中的所有 ToggleButton 控件隐式创建样式，并且应用程序具有 ToggleButton 和 CheckBox 控件， (CheckBox 派生自 ToggleButton) ，则“ToggleButton”隐式样式仅应用于 ToggleButton 控件。

适用于

另请参阅

• OnApplyTemplate()
• GetTemplateChild(String)
• ControlTemplate
• Style
• XAML 控件模板