VisualState Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Reprezentuje wygląd wizualizacji kontrolki, gdy znajduje się w określonym stanie.

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

Dziedziczenie

Object

DispatcherObject

DependencyObject

VisualState

Atrybuty

ContentPropertyAttribute RuntimeNamePropertyAttribute

Przykłady

Poniższy przykład tworzy obiekt VisualStateGroup w ButtonControlTemplate obiekcie o nazwie CommonStates i dodaje VisualState obiekty dla stanów , Normal, Pressedi MouseOver. Element Button definiuje również stan o nazwie Disabled , który znajduje się w CommonStatesVisualStateGroupobiekcie , ale w przykładzie pominięto go w celu zwięzłości. W całym przykładzie zobacz Jak utworzyć szablon dla kontrolki.

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

Uwagi

A VisualState określa, jak wygląda kontrolka, gdy znajduje się w określonym stanie. Na przykład po naciśnięciu Button obramowania może być inny niż normalny. Klasa VisualState ma Storyboard właściwość, która zmienia wygląd kontrolki. Gdy kontrolka wprowadza stan określony przez VisualState.Name właściwość , Storyboard rozpoczyna się. Gdy kontrolka kończy stan, Storyboard zatrzymuje się.

Właściwość VisualStateGroup.States zawiera VisualState obiekty. VisualStateGroup obiekty są dodawane do dołączonej VisualStateManager.VisualStateGroups właściwości, która jest zdefiniowana na obiekcie w obiekcie FrameworkElement. Obiekty można dodawać VisualState do dowolnego FrameworkElementobiektu , ale są one zwykle używane w obiekcie ControlTemplateControl. Aby uzyskać informacje o sposobie tworzenia obiektów i VisualState dla istniejących kontrolek, zobacz How to create a template for a control (Jak utworzyć szablon dla kontrolki).ControlTemplate Aby zapoznać się z przykładem używania VisualState obiektów spoza klasy ControlTemplate, zobacz klasę VisualStateManager .

Konstruktory

Nazwa	Opis
VisualState()	Inicjuje nowe wystąpienie klasy VisualState.

Właściwości

Nazwa	Opis
DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera elementDispatcher, z który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Name	Pobiera lub ustawia nazwę VisualStateelementu .
Storyboard	Pobiera lub ustawia element Storyboard definiujący wygląd kontrolki, gdy znajduje się w stanie reprezentowanym przez VisualStateelement .

Metody

Nazwa	Opis
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego elementu DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości na tym DependencyObjectobiekcie . (Odziedziczone po DependencyObject)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza obowiązującą wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy zostanie zaktualizowana efektywna wartość dowolnej właściwości DependencyObject zależności. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)