ControlTemplate Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie la structure visuelle et les aspects comportementaux d'un Control qui peuvent être partagés par plusieurs instances du contrôle.
public ref class ControlTemplate : System::Windows::FrameworkTemplate[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.DictionaryKeyProperty("TargetType")]
public class ControlTemplate : System.Windows.FrameworkTemplate[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.DictionaryKeyProperty("TargetType")>]
type ControlTemplate = class
inherit FrameworkTemplatePublic Class ControlTemplate
Inherits FrameworkTemplate- Héritage
- Attributs
Exemples
Voici un Button Style exemple qui définit l’un ControlTemplate des éléments suivants Button:
<Style TargetType="Button">
<!--Set to true to not get any properties from the themes.-->
<Setter Property="OverridesDefaultStyle" Value="True"/>
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="Button">
<Grid>
<Ellipse Fill="{TemplateBinding Background}"/>
<ContentPresenter HorizontalAlignment="Center"
VerticalAlignment="Center"/>
</Grid>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style>
Lorsque cela est appliqué, le message Button apparaît sous la forme suivante Ellipse:
Lorsque vous définissez la Template propriété d’un Control nouveau ControlTemplate comme dans l’exemple ci-dessus, vous remplacez l’intégralité du modèle. Button À quoi ressemble le moment où il est activé ou appuyé fait partie de l’apparence par défaut du bouton que vous remplacez. Par conséquent, en fonction de vos besoins, vous pouvez placer dans votre définition ce que votre bouton doit ressembler lorsqu’il est enfoncé, et ainsi de suite, comme dans l’exemple suivant :
<Style TargetType="Button">
<Setter Property="SnapsToDevicePixels"
Value="true" />
<Setter Property="OverridesDefaultStyle"
Value="true" />
<Setter Property="FocusVisualStyle"
Value="{StaticResource ButtonFocusVisual}" />
<Setter Property="MinHeight"
Value="23" />
<Setter Property="MinWidth"
Value="75" />
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="Button">
<Border TextBlock.Foreground="{TemplateBinding Foreground}"
x:Name="Border"
CornerRadius="2"
BorderThickness="1">
<Border.BorderBrush>
<LinearGradientBrush StartPoint="0,0"
EndPoint="0,1">
<LinearGradientBrush.GradientStops>
<GradientStopCollection>
<GradientStop Color="{DynamicResource BorderLightColor}"
Offset="0.0" />
<GradientStop Color="{DynamicResource BorderDarkColor}"
Offset="1.0" />
</GradientStopCollection>
</LinearGradientBrush.GradientStops>
</LinearGradientBrush>
</Border.BorderBrush>
<Border.Background>
<LinearGradientBrush EndPoint="0.5,1"
StartPoint="0.5,0">
<GradientStop Color="{DynamicResource ControlLightColor}"
Offset="0" />
<GradientStop Color="{DynamicResource ControlMediumColor}"
Offset="1" />
</LinearGradientBrush>
</Border.Background>
<VisualStateManager.VisualStateGroups>
<VisualStateGroup x:Name="CommonStates">
<VisualStateGroup.Transitions>
<VisualTransition GeneratedDuration="0:0:0.5" />
<VisualTransition GeneratedDuration="0"
To="Pressed" />
</VisualStateGroup.Transitions>
<VisualState x:Name="Normal" />
<VisualState x:Name="MouseOver">
<Storyboard>
<ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Panel.Background).
(GradientBrush.GradientStops)[1].(GradientStop.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource ControlMouseOverColor}" />
</ColorAnimationUsingKeyFrames>
</Storyboard>
</VisualState>
<VisualState x:Name="Pressed">
<Storyboard>
<ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Panel.Background).
(GradientBrush.GradientStops)[1].(GradientStop.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource ControlPressedColor}" />
</ColorAnimationUsingKeyFrames>
<ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Border.BorderBrush).
(GradientBrush.GradientStops)[0].(GradientStop.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource PressedBorderDarkColor}" />
</ColorAnimationUsingKeyFrames>
<ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Border.BorderBrush).
(GradientBrush.GradientStops)[1].(GradientStop.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource PressedBorderLightColor}" />
</ColorAnimationUsingKeyFrames>
</Storyboard>
</VisualState>
<VisualState x:Name="Disabled">
<Storyboard>
<ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Panel.Background).
(GradientBrush.GradientStops)[1].(GradientStop.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource DisabledControlDarkColor}" />
</ColorAnimationUsingKeyFrames>
<ColorAnimationUsingKeyFrames
Storyboard.TargetProperty="(TextBlock.Foreground).(SolidColorBrush.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource DisabledForegroundColor}" />
</ColorAnimationUsingKeyFrames>
<ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Border.BorderBrush).
(GradientBrush.GradientStops)[1].(GradientStop.Color)"
Storyboard.TargetName="Border">
<EasingColorKeyFrame KeyTime="0"
Value="{StaticResource DisabledBorderDarkColor}" />
</ColorAnimationUsingKeyFrames>
</Storyboard>
</VisualState>
</VisualStateGroup>
</VisualStateManager.VisualStateGroups>
<ContentPresenter Margin="2"
HorizontalAlignment="Center"
VerticalAlignment="Center"
RecognizesAccessKey="True" />
</Border>
<ControlTemplate.Triggers>
<Trigger Property="IsDefault"
Value="true">
<Setter TargetName="Border"
Property="BorderBrush">
<Setter.Value>
<LinearGradientBrush StartPoint="0,0"
EndPoint="0,1">
<GradientBrush.GradientStops>
<GradientStopCollection>
<GradientStop Color="{DynamicResource DefaultBorderBrushLightBrush}"
Offset="0.0" />
<GradientStop Color="{DynamicResource DefaultBorderBrushDarkColor}"
Offset="1.0" />
</GradientStopCollection>
</GradientBrush.GradientStops>
</LinearGradientBrush>
</Setter.Value>
</Setter>
</Trigger>
</ControlTemplate.Triggers>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style>
Notez que cet exemple référence les ressources qui ne sont pas affichées ici. Pour voir l’exemple complet, consultez Styling with ControlTemplates Sample (Exemple de style avec ControlTemplates). Cet exemple fournit des exemples de modèles de contrôle pour de nombreux contrôles et constitue la meilleure façon de commencer à créer des modèles de contrôle.
Remarques
Vous ControlTemplate pouvez spécifier la structure visuelle d’un contrôle. L’auteur du contrôle peut définir la valeur par défaut ControlTemplate et l’auteur de l’application peut remplacer la ControlTemplate structure visuelle du contrôle.
La création de modèles de contrôle est l’une des nombreuses fonctionnalités offertes par le modèle de style et de création de modèles WPF. Le modèle de style et de création de modèles vous offre une telle flexibilité que, dans de nombreux cas, vous n’avez pas besoin d’écrire vos propres contrôles. Si vous êtes un auteur d’application qui souhaite modifier la visualisation de votre contrôle ou remplacer le ControlTemplate contrôle existant, consultez la rubrique Style et Création de modèles pour obtenir des exemples et une discussion approfondie.
Si vous écrivez votre propre contrôle, consultez « Créer un contrôle personnalisé » dans la vue d’ensemble de la création de contrôles.
Il ControlTemplate s’agit d’une unité autonome de détails d’implémentation invisible pour les utilisateurs et les objets extérieurs, y compris les styles. La seule façon de manipuler le contenu du modèle de contrôle provient du même modèle de contrôle.
Utilisation des éléments de propriété XAML
<ControlTemplate>
<VisualTreeRootNode>
VisualTreeNodeContents
</VisualTreeRootNode>
</ControlTemplate>
Valeurs XAML
ControlTemplate
Élément Object pour ControlTemplate ou une classe dérivée.
VisualTreeRootNode
Élément XAML unique en tant qu’enfant immédiat du ControlTemplate (ou d’une classe dérivée). Les modèles doivent avoir un nœud racine unique. Pour générer un modèle utile, l’élément choisi comme VisualTreeRootNode est censé prendre en charge un modèle de contenu propre, souvent un modèle qui prend en charge plusieurs éléments enfants.
VisualTreeNodeContents
Un ou plusieurs éléments qui terminent le modèle prévu. Si l’élément choisi comme VisualTreeRootNode ne prend en charge qu’un seul enfant, il ne peut y avoir qu’un seul élément déclaré comme VisualTreeNodeContents. Il est également possible (bien que rare) de fournir du contenu texte si visualTreeRootNode choisi prend en charge une propriété de contenu texte.
Constructeurs
| ControlTemplate() |
Initialise une nouvelle instance de la classe ControlTemplate. |
| ControlTemplate(Type) |
Initialise une nouvelle instance de la classe ControlTemplate à l'aide du type de cible spécifié. |
Propriétés
| Dispatcher |
Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject) |
| HasContent |
Obtient une valeur qui indique si ce modèle a optimisé le contenu. (Hérité de FrameworkTemplate) |
| IsSealed |
Obtient une valeur qui indique si cet objet est dans un état immuable (c'est-à-dire qu'il ne peut pas être modifié). (Hérité de FrameworkTemplate) |
| Resources |
Obtient ou définit la collection des ressources qui peuvent être utilisées dans la portée de ce modèle. (Hérité de FrameworkTemplate) |
| TargetType |
Obtient ou définit le type auquel ce ControlTemplate est destiné. |
| Template |
Obtient ou définit une référence à l'objet qui enregistre ou lit les nœuds XAML pour le modèle lorsque le modèle est défini ou appliqué par un writer. (Hérité de FrameworkTemplate) |
| Triggers |
Obtient une collection d'objets TriggerBase qui appliquent des modifications de propriété ou effectuent des actions selon des conditions spécifiées. |
| VisualTree |
Obtient ou définit le nœud racine du modèle. (Hérité de FrameworkTemplate) |
Méthodes
| CheckAccess() |
Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| FindName(String, FrameworkElement) |
Recherche l’élément associé au nom spécifié défini dans ce modèle. (Hérité de FrameworkTemplate) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| LoadContent() |
Charge le contenu du modèle en tant qu'instance d'un objet et retourne l'élément racine du contenu. (Hérité de FrameworkTemplate) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| RegisterName(String, Object) |
Inscrit une nouvelle paire nom-objet dans la portée de nom active. (Hérité de FrameworkTemplate) |
| Seal() |
Verrouille le modèle de façon à ce qu'il ne puisse pas être modifié. (Hérité de FrameworkTemplate) |
| ShouldSerializeResources(XamlDesignerSerializationManager) |
Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété Resources sur les instances de cette classe. (Hérité de FrameworkTemplate) |
| ShouldSerializeVisualTree() |
Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété VisualTree sur les instances de cette classe. (Hérité de FrameworkTemplate) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| UnregisterName(String) |
Supprime un mappage nom/objet de la portée de nom XAML. (Hérité de FrameworkTemplate) |
| ValidateTemplatedParent(FrameworkElement) |
Vérifie le parent basé sur des modèles par rapport à un ensemble de règles. |
| VerifyAccess() |
Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject) |
Implémentations d’interfaces explicites
| INameScope.FindName(String) |
Retourne un objet qui a le nom d’identification fourni. (Hérité de FrameworkTemplate) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
Demande si une propriété ambiante spécifiée est disponible dans la portée actuelle. (Hérité de FrameworkTemplate) |