VisualState.Storyboard Proprietà

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>

Valore della proprietà

Storyboard che definisce le modifiche alla proprietà da applicare al controllo quando questo oggetto VisualState viene usato come stato visivo corrente.

Esempio

In questo esempio viene creato un semplice ControlloTemplate per un pulsante che contiene una griglia. VisualState con il valore dell'attributo x:Name di "PointerOver" ha un storyboard che modifica il colore del contenuto del pulsante (a Grid) da verde a rosso quando l'utente inserisce il puntatore su Button. VisualState con il valore dell'attributo x:Name di "Normal" è incluso in modo che quando l'utente sposta il puntatore dal pulsante, lo Grid sfondo restituisce verde.

<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>

Commenti

Il valore della proprietà Storyboard è null o un singolo Storyboard oggetto. Un Storyboard oggetto è simile a un contenitore per le animazioni. Può contenere una o più definizioni di animazione. Ogni animazione può essere destinazione di una proprietà di dipendenza specifica in una destinazione denominata specifica. La destinazione denominata deve essere un elemento nel modello di controllo con un valore attributo Name o x:Name definito nel modello stesso. La proprietà di dipendenza deve essere una proprietà presente nel modello a oggetti di tale oggetto o in una proprietà associata. Per indirizzare le animazioni, usare le proprietà associate Storyboard.TargetName e Storyboard.TargetProperty . Per altre informazioni su come definire animazioni con sintassi XAML e i tipi di animazioni che è possibile usare, vedere Animazioni storyboard.

Le animazioni che influiscono sul layout sono potenzialmente animazioni dipendenti, che possono avere conseguenze sulle prestazioni per gli utenti del controllo quando il controllo carica un oggetto VisualState.

Si applica a

Vedi anche

• Storyboard
• Animazioni con storyboard
• Modelli di controllo XAML
• Esempio di controllo XAML e stile dell'app