Partager via


VisualState.Storyboard Propriété

Définition

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. VisualState avec la valeur d’attribut x:Name de « PointerOver » a un storyboard qui modifie la couleur du contenu du bouton (une grille) du vert au rouge lorsque l’utilisateur place le pointeur sur le bouton. VisualState avec la valeur d’attribut x:Name de « Normal » est inclus de sorte que lorsque l’utilisateur déplace le pointeur hors 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 null ou un seul objet 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. Pour plus d’informations, voir Animations dans une table de montage séquentiel pour les états visuels.

S’applique à

Voir aussi