VisualState Klasse

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Stellt die visuelle Darstellung des Steuerelements dar, wenn es sich in einem bestimmten Zustand befindet.

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 ein VisualStateGroup In der ControlTemplate Aufgerufenen ButtonCommonStates erstellt und VisualState Objekte für die Zustände, Normal, , Pressedund MouseOver. Außerdem Button wird ein Zustand Disabled definiert, der CommonStatesVisualStateGroupsich im Zustand befindet, aber im Beispiel wird er aus Platzgründen weggelassen. Das gesamte Beispiel finden Sie unter How to create a template for a control.

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

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

Die VisualStateGroup.States Eigenschaft enthält VisualState Objekte. VisualStateGroup objekte werden der VisualStateManager.VisualStateGroups angefügten Eigenschaft hinzugefügt, die für die in einer FrameworkElement. Sie können jedem Objekt Objekte hinzufügenVisualState, aber sie werden in der Regel in einem ControlTemplate von einem Control.FrameworkElement Informationen zum Erstellen eines Steuerelements und VisualState von ControlTemplate Objekten für vorhandene Steuerelemente finden Sie unter How to create a template for a control. Ein Beispiel für die Verwendung VisualState von Objekten außerhalb einer ControlTemplateKlasse finden Sie in der VisualStateManager Klasse.

Konstruktoren

Name	Beschreibung
VisualState()	Initialisiert eine neue Instanz der VisualState-Klasse.

Eigenschaften

Name	Beschreibung
DependencyObjectType	Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject)
Dispatcher	Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject)
Name	Dient zum Abrufen oder Festlegen des Namens der VisualState.
Storyboard	Dient zum Abrufen oder Festlegen eines Storyboard Werts, der die Darstellung des Steuerelements definiert, wenn es sich in dem Zustand befindet, der durch die VisualState.

Methoden

Name	Beschreibung
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
VerifyAccess()	Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)