VisualState.Storyboard Eigenschaft

Referenz

Definition

Namespace:: Windows.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft ein Storyboard ab , das zustandsspezifische Eigenschaftswerte und die Darstellung des Steuerelements definiert, wenn es diesen visuellen Zustand verwendet, oder legt dieses fest.

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>

Eigenschaftswert

Storyboard

Ein Storyboard , das die Eigenschaftsänderungen definiert, die auf das Steuerelement angewendet werden sollen, wenn dieser VisualState als aktueller visueller Zustand verwendet wird.

Beispiele

In diesem Beispiel wird eine einfache ControlTemplate für eine Schaltfläche erstellt, die ein Raster enthält. VisualState mit dem x:Name-Attributwert von "PointerOver" verfügt über ein Storyboard, das die Farbe des Schaltflächeninhalts (raster) von grün in rot ändert, wenn der Benutzer den Zeiger auf die Schaltfläche legt. VisualState mit dem x:Name-Attributwert "Normal" ist enthalten, sodass der Rasterhintergrund wieder grün wird, wenn der Benutzer den Zeiger von der Schaltfläche verschiebt.

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

Hinweise

Der Wert der Storyboard-Eigenschaft ist entweder NULL oder ein einzelnes Storyboard-Objekt . Ein Storyboard ist wie ein Container für Animationen. Sie kann mindestens eine Animationsdefinition enthalten. Jede solche Animation kann auf eine bestimmte Abhängigkeitseigenschaft für ein bestimmtes benanntes Ziel abzielen. Das benannte Ziel muss ein Element in der Steuerelementvorlage sein, das über einen Name - oder x:Name-Attributwert verfügt, der in der Vorlage selbst definiert ist. Die Abhängigkeitseigenschaft muss eine Eigenschaft sein, die im Objektmodell dieses Objekts vorhanden ist, oder eine angefügte Eigenschaft. Zum Zielanimieren verwenden Sie die angefügten Eigenschaften Storyboard.TargetName und Storyboard.TargetProperty . Weitere Informationen zum Definieren von Animationen mit XAML-Syntax und zu den Animationstypen, die Sie verwenden können, finden Sie unter Storyboardanimationen.

Animationen, die sich auf das Layout auswirken, sind potenziell abhängige Animationen, die auswirkungen auf die Leistung für Benutzer Ihres Steuerelements haben können, wenn das Steuerelement einen VisualState lädt. Weitere Informationen finden Sie unter Storyboardanimationen für visuelle Zustände.

Gilt für: