ControlTemplate, classe
TOC
Réduire la table des matières
Développer la table des matières

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

ControlTemplateClasse comporte les constructeurs suivants.

ConstructeurDescription
ControlTemplate Initializes a new instance of the ControlTemplate class.

 

Méthodes

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

MéthodeDescription
ClearValue Clears the local value of a dependency property. (Hérité de DependencyObject)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Hérité de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Hérité de DependencyObject)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Hérité de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Hérité de DependencyObject)

 

Propriétés

Le ControlTemplateClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Dispatcher

en lecture seuleGets the CoreDispatcher that this object is associated with. (Hérité de DependencyObject)

TargetType

en lecture/écritureGets or sets the type to which the ControlTemplate is applied.

 

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

Client minimal pris en charge

Windows 8 [Applications du Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store uniquement]

Espace de noms

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Métadonnées

Windows.winmd

Voir aussi

FrameworkTemplate

 

 

Afficher:
© 2017 Microsoft