ControlTemplate Class

Définit l'arborescence d'éléments appliquée comme modèle de contrôle pour un contrôle.

Héritage

Object

  DependencyObject

    FrameworkTemplate

      ControlTemplate

Syntaxe

public sealed class ControlTemplate : FrameworkTemplate

<ControlTemplate ...>
    templateRootElement
</ControlTemplate>

XAML Values

templateRootElement

Élément objet unique dérivé de FrameworkElement. Le templateRootElement est souvent un panneau qui contient d'autres éléments.

Attributs

ActivatableAttribute(NTDDI_WIN8)

MarshalingBehaviorAttribute(Agile)

ThreadingAttribute(Both)

VersionAttribute(NTDDI_WIN8)

WebHostHiddenAttribute()

Membres

ControlTemplateClasse comporte les types de membres suivants :

• Constructeurs
• Méthodes
• Propriétés

Constructeurs

ControlTemplateClasse comporte les constructeurs suivants.

Méthodes

The ControlTemplate Classe comporte les méthodes suivantes. Il hérite également des méthodes de Object Classe.

Propriétés

Le ControlTemplateClasse contient les propriétés suivantes.

Remarques

Le contenu d'un modèle tel que ControlTemplate ou DataTemplate n'est pas accessible via une simple API d'exécution. Définir un modèle est un scénario pour l'utilisation du langage XAML, et la valeur est assignée purement en tant qu'opération d'analyse XAML. Vous disposez de moyens pour accéder au contenu de modèle lorsqu'il a été appliqué à un contrôle spécifique. Consultez la méthode OnApplyTemplate ou GetTemplateChild.

Exemples

L'exemple suivant crée un ControlTemplate simple pour un Button. Le modèle de contrôle contient un Grid et spécifie le comportement suivant :

• Lorsque l'utilisateur place la souris sur le Button, la Grid passe du vert au rouge en une demi-seconde.

• Lorsque l'utilisateur déplace la souris loin du bouton, le Grid redevient immédiatement vert.

<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to transition to the PointerOver state.-->
          <VisualTransition To="PointerOver" 
                              GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>
        
        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            Pointer is over the button.-->
        <VisualState x:Name="PointerOver">
          <Storyboard>
            <ColorAnimation Storyboard.TargetName="ButtonBrush" 
                            Storyboard.TargetProperty="Color" To="Red" />
          </Storyboard>
        </VisualState>
      </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Grid.Background>
      <SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
    </Grid.Background>
  </Grid>
</ControlTemplate>

Configuration requise

Voir aussi

FrameworkTemplate