VisualState.Storyboard Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml
Modifica

Ottiene o imposta un oggetto Storyboard che definisce i valori di proprietà specifici dello stato e l'aspetto del controllo quando usa questo stato visivo.

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

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 (griglia) da verde a rosso quando l'utente inserisce il puntatore sul pulsante. VisualState con il valore dell'attributo x:Name di "Normal" viene incluso in modo che quando l'utente sposta il puntatore sul pulsante, lo sfondo griglia viene restituito in 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 oggetto Storyboard . Un storyboard è come 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. Per altre info, vedi Animazioni con storyboard per stati di visualizzazione.

Si applica a

Vedi anche