VisualStateManager-Klasse

VisualStateManager ermöglicht es Ihnen, Zustände für ein Steuerelement anzugeben, die Darstellung eines Steuerelements, wenn es in einem bestimmten Zustand ist und wenn ein Steuerelement Zustände ändert. Ein Button könnte z. B. beim Klicken eine etwas andere Darstellung haben als wenn nicht geklickt wird. Zwei Zustände, die Button definiert; sie entsprechen einer gedrückten Taste ("Pressed") und einer nicht gedrückten Taste ("Normal"). Die Darstellung eines Steuerelements, wenn es in einem Zustand ist, wird von einem VisualState definiert. Ein VisualState enthält eine Auflistung von Storyboard-Objekten, die angeben, wie sich die Darstellung des Steuerelements ändert, wenn sich das Steuerelement in diesem Zustand befindet. Sie fügen visuelle Zustände zu einem Steuerelement hinzu, indem Sie die angefügte VisualStateManager.VisualStateGroups-Eigenschaft des Steuerelements festlegen. Jede VisualStateGroup enthält eine Auflistung sich gegenseitig ausschließender VisualState-Objekte. Das heißt, das Steuerelement befindet sich immer genau in einem Zustand in jeder VisualStateGroup.

Der VisualStateManager ermöglicht es Ihnen zudem anzugeben, wann ein Steuerelement in einen bestimmten Zustand eintritt. Die Methode, die Sie aufrufen sollten, um Zustände zu ändern, hängt vom Szenario ab. Wenn Sie ein Steuerelement erstellen, dass den VisualStateManager in seiner ControlTemplate verwendet, rufen Sie die GoToState-Methode auf. Weitere Informationen zum Erstellen von Steuerelementen, die den VisualStateManager verwenden, finden Sie unter Erstellen eines Steuerelements mit einer anpassbaren Darstellung. Wenn Sie den VisualStateManager außerhalb einer ControlTemplate verwenden (Z. B., wenn Sie einen VisualStateManager in einem UserControl oder einem einzelnen Element verwenden), rufen Sie die GoToElementState-Methode auf. In jedem Fall führt VisualStateManager die erforderliche Logik aus, um die dem betreffenden Zustand zugeordneten Storyboards zu starten und zu beenden. Angenommen, ein Steuerelement definiert die Zustände, State1 und State2, von denen jedem ein Storyboard zugeordnet ist. Wenn das Steuerelement in State1 ist, und Sie übergeben State2 an GoToState oder GoToElementState, startet der VisualStateManager das Storyboard in State2 und beendet das Storyboard in State1.

Steuerelemente, die in Windows Presentation Foundation (WPF) enthalten sind, ändern visuelle Zustände mithilfe des VisualStateManager. Wenn Sie eine ControlTemplate für ein Steuerelement erstellen, das in WPF enthalten ist, können Sie VisualState-Objekte zur ControlTemplate des Steuerelements hinzufügen, um die Darstellung des Steuerelements in einem bestimmten Zustand anzugeben. Informationen zum Suchen der Namen des visuellen Zustände für die Steuerelemente, die in WPF enthalten sind, finden Sie unter Control-Stile und -Vorlagen. Die Logik des Steuerelements behandelt den Übergang zwischen Zuständen, deshalb müssen Sie nur die VisualState-Objekte in der neuen ControlTemplate definieren. Weitere Informationen zum Erstellen von Steuerelementvorlagen für vorhandene Steuerelemente finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate.

Wenn Sie eine eigene Logik für Übergänge zwischen Zuständen implementieren möchten, müssen Sie von VisualStateManager erben, die GoToStateCore-Methode überschreiben und die angefügte VisualStateManager.CustomVisualStateManager-Eigenschaft auf das Steuerelement festlegen, das die benutzerdefinierte Logik verwendet.

Im folgenden Beispiel wird ein Rectangle erstellt und ein VisualStateGroup namens CommonStates der angefügten VisualStateManager.VisualStatesGroups-Eigenschaft hinzugefügt. Dieses Beispiel definiert das MouseOver-Objekt und das NormalVisualState-Objekt in CommonStatesVisualStateGroup. Wenn der Benutzer den Mauszeiger über das Rectangle führt, wechselt seine Farbe für eine halbe Sekunde von rot nach grün. Wenn der Benutzer die Maus vom Rechteck entfernt, wechselt das Grid sofort zu rot zurück. Beachten Sie, dass der Normal-Zustand Storyboard nicht definiert. Ein Storyboard ist nicht erforderlich, da beim Übergang des Rectangle vom MouseOver-Zustand in den Normal-Zustand das Storyboard für MouseOver angehalten wird und die Color-Eigenschaft für die SolidColorBrush auf rot zurückwechselt.

<Rectangle Name="rect" 
           Width="100" Height="100"
           MouseEnter="rect_MouseEvent" 
           MouseLeave="rect_MouseEvent">
  <VisualStateManager.VisualStateGroups>
    <VisualStateGroup Name="MouseStates">
      <VisualState Name="MouseEnter">
        <Storyboard>
          <ColorAnimation To="Green" 
                          Storyboard.TargetName="rectBrush" 
                          Storyboard.TargetProperty="Color"/>
        </Storyboard>
      </VisualState>
      <VisualState Name="MouseLeave" />
      <VisualStateGroup.Transitions>
        <VisualTransition To="MouseLeave" GeneratedDuration="00:00:00"/>

        <VisualTransition To="MouseEnter" GeneratedDuration="00:00:00.5">
          <VisualTransition.GeneratedEasingFunction>
            <ExponentialEase EasingMode="EaseOut" Exponent="10"/>
          </VisualTransition.GeneratedEasingFunction>
        </VisualTransition>

      </VisualStateGroup.Transitions>
    </VisualStateGroup>
  </VisualStateManager.VisualStateGroups>

  <Rectangle.Fill>
    <SolidColorBrush x:Name="rectBrush" Color="Red"/>
  </Rectangle.Fill>
</Rectangle>

Im folgenden Beispiel wird der Ereignishandler veranschaulicht, der im vorherigen Beispiel definiert wurde, und die GoToElementState-Methode für den Übergang zwischen Zuständen aufgerufen. Wenn das Rechteck im vorherigen Beispiel Teil einer ControlTemplate war, muss im Beispiel die GoToState-Methode aufgerufen werden.

private void rect_MouseEvent(object sender, MouseEventArgs e)
{
    if (rect.IsMouseOver)
    {
        VisualStateManager.GoToElementState(rect, "MouseEnter", true);
    }
    else
    {
        VisualStateManager.GoToElementState(rect, "MouseLeave", true);
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen