Control.Template 屬性

參考

定義

命名空間:: Microsoft.UI.Xaml.Controls

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

取得或設定控制項範本。控件範本會定義 UI 中控制件的視覺外觀，並在 XAML 標記中定義。

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

定義控件外觀的範本。 ControlTemplate 必須只有一個根元素做為其內容。

範例

此範例示範定義為 Style 和 Setter 的更完整控件範本，其 Setter.Property 值為 “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 語法是 Setter 語法作為 Style 的一部分。這是控件的範本值在幾乎所有情況下定義的方式。

TargetType 是做為範本值之所有 ControlTemplate 元素的必要屬性。如果您使用 style-setter 語法，此值應該符合包含 Template Setter 之 Style 的 TargetType 屬性。

ControlTemplate 會指定 Control 的外觀;如果 Control 沒有 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，將值套用至任何相依性屬性。但它是 Control 衍生類別之 Template 屬性的 Setter，其構成一般 Style 中大部分的 XAML 標記。使用 Style 來定義控件範本時，Style 元素的 TargetType 及其 Control.Template setter 的 ControlTemplate 元素 TargetType 應該一律使用相同的值。 Template setter 會定義套用該範本之控件的基本樣板化 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 控件。

適用於

Control.Template 屬性

定義

屬性值

範例

備註

樣式及範本

隱含樣式

適用於

另請參閱

意見反應

意見反應

其他資源