Freigeben über


VisualState.Storyboard Eigenschaft

Definition

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

Ein Storyboard , das die Eigenschaftenä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 "PointerOver" verfügt über ein Storyboard, das die Farbe des Schaltflächeninhalts (a Grid) von grün in rot ändert, wenn der Benutzer den Mauszeiger über das Buttonzeigt. VisualState mit dem x:Name-Attributwert "Normal" ist enthalten, sodass der Hintergrund wieder grün angezeigt wird, Grid 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 und kann eine oder mehrere Animationsdefinitionen enthalten. Jede solche Animation kann auf eine bestimmte Abhängigkeitseigenschaft auf 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. Um Animationen als Ziel zu verwenden, verwenden Sie die angefügten Eigenschaften Storyboard.TargetName und Storyboard.TargetProperty . Weitere Informationen zum Definieren von Animationen mit XAML-Syntax und zu den Arten von Animationen, 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 des Steuerelements haben können, wenn das Steuerelement einen VisualState lädt.

Gilt für:

Weitere Informationen