VisualState Klasse

Definition

public ref class VisualState : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("Storyboard")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualState : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("Storyboard")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualState = class
    inherit DependencyObject

Public Class VisualState
Inherits DependencyObject

Vererbung

Object

DispatcherObject

DependencyObject

VisualState

Attribute

ContentPropertyAttribute RuntimeNamePropertyAttribute

Beispiele

Im folgenden Beispiel wird eine VisualStateGroup im ControlTemplate eines Button namens CommonStates erstellt und VisualState Objekte für die Zustände, Normal, Pressedund MouseOverhinzugefügt. Die Button definiert auch einen Zustand namens Disabled, der sich im CommonStatesVisualStateGroupbefindet, aber im Beispiel wird er aus Platzgründen weggelassen. Das gesamte Beispiel finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate-.

  <!--Define the states and transitions for the common states.
      The states in the VisualStateGroup are mutually exclusive to
      each other.-->
  <VisualStateGroup x:Name="CommonStates">

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.-->
    <VisualState x:Name="Normal" />

    <!--Change the SolidColorBrush, BorderBrush, to red when the
        mouse is over the button.-->
    <VisualState x:Name="MouseOver">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color" 
                        To="Red" />
      </Storyboard>
    </VisualState>

    <!--Change the SolidColorBrush, BorderBrush, to Transparent when the
        button is pressed.-->
    <VisualState x:Name="Pressed">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color"
                        To="Transparent"/>
      </Storyboard>
    </VisualState>

    <!--The Disabled state is omitted for brevity.-->
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

Hinweise

Ein VisualState gibt an, wie das Steuerelement aussieht, wenn es sich in einem bestimmten Zustand befindet. Wenn beispielsweise ein Button gedrückt wird, kann der Rahmen eine andere Farbe als normal sein. Die VisualState Klasse verfügt über eine Storyboard-Eigenschaft, die das Erscheinungsbild des Steuerelements ändert. Wenn das Steuerelement den Zustand eingibt, der durch die VisualState.Name-Eigenschaft angegeben wird, beginnt die Storyboard. Wenn das Steuerelement den Zustand verlässt, wird der Storyboard beendet.

Die VisualStateGroup.States-Eigenschaft enthält VisualState Objekte. VisualStateGroup Objekte werden der angefügten VisualStateManager.VisualStateGroups-Eigenschaft hinzugefügt, die für eine FrameworkElementdefiniert ist. Sie können jedem FrameworkElementVisualState Objekte hinzufügen, werden jedoch in der Regel in einer ControlTemplate eines Controlverwendet. Informationen zum Erstellen eines ControlTemplate- und VisualState-Objekts für vorhandene Steuerelemente finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate-. Ein Beispiel für die Verwendung von VisualState Objekten außerhalb eines ControlTemplatefinden Sie in der VisualStateManager Klasse.

Konstruktoren

Eigenschaften

Methoden

Gilt für: