VisualState.Storyboard Propriété
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.
Obtient ou définit un Storyboard qui définit des valeurs de propriété spécifiques à l’état et l’apparence du contrôle lorsqu’il utilise cet état visuel.
public:
property Storyboard ^ Storyboard { Storyboard ^ get(); void set(Storyboard ^ value); };Storyboard Storyboard();
void Storyboard(Storyboard value);public Storyboard Storyboard { get; set; }var storyboard = visualState.storyboard;
visualState.storyboard = storyboard;Public Property Storyboard As Storyboard<VisualState>
singleStoryboard
</VisualState>
Valeur de propriété
Storyboard qui définit les modifications de propriété à appliquer au contrôle lorsque ce VisualState est utilisé comme état visuel actuel.
Exemples
Cet exemple crée un ControlTemplate simple pour un Button qui contient une grille. Le VisualState avec la valeur d’attribut x:Name de « PointerOver » a un storyboard qui modifie la couleur du contenu du bouton (un Grid) du vert au rouge lorsque l’utilisateur place le pointeur sur le Button.
VisualState avec la valeur d’attribut x:Name de « Normal » est inclus de sorte que lorsque l’utilisateur déplace le pointeur du bouton, l’arrière-plan Grid revient au 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>
Remarques
La valeur de la propriété Storyboard est ou null un objet unique Storyboard . Un Storyboard est comme un conteneur pour les animations ; il peut contenir une ou plusieurs définitions d’animation. Chaque animation de ce type peut cibler une propriété de dépendance spécifique sur une cible nommée spécifique. La cible nommée doit être un élément dans le modèle de contrôle qui a une valeur d’attribut Name ou x:Name définie dans le modèle lui-même. La propriété de dépendance doit être une propriété qui existe dans le modèle objet de cet objet, ou une propriété jointe. Pour cibler des animations, vous utilisez les propriétés jointes Storyboard.TargetName et Storyboard.TargetProperty . Pour plus d’informations sur la définition d’animations avec la syntaxe XAML et les types d’animations que vous pouvez utiliser, consultez Animations storyboard.
Les animations qui affectent la disposition sont potentiellement dépendantes, ce qui peut avoir des conséquences sur les performances pour les utilisateurs de votre contrôle lorsque le contrôle charge un VisualState.