VisualState Osztály

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

A vezérlő vizuális megjelenését jelzi, ha egy adott állapotban van.

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

Öröklődés

Object

DispatcherObject

DependencyObject

VisualState

Attribútumok

ContentPropertyAttribute RuntimeNamePropertyAttribute

Példák

Az alábbi példa létrehoz egy VisualStateGroupControlTemplateButton meghívott CommonStates objektumot, és objektumokat ad VisualState hozzá az állapotokhoz, PressedNormalés MouseOvera . A Button példa egy úgynevezett Disabled állapotot is definiál, de CommonStatesVisualStateGroupa példa kihagyja a rövidség kedvéért. A teljes példában a vezérlők sablonjának létrehozása című témakörben olvashat.

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

Megjegyzések

Az A VisualState azt határozza meg, hogyan néz ki a vezérlő, ha egy adott állapotban van. Ha például lenyom egy Button gombot, a szegélye a szokásostól eltérő színű lehet. Az VisualState osztálynak van egy Storyboard tulajdonsága, amely megváltoztatja a vezérlő megjelenését. Amikor a vezérlőelem belép a tulajdonság által VisualState.Name megadott állapotba, a Storyboard rendszer elindul. Amikor a vezérlő kilép az állapotból, a Storyboard rendszer leáll.

A VisualStateGroup.States tulajdonság objektumokat tartalmaz VisualState . VisualStateGroup objektumokat ad hozzá a VisualStateManager.VisualStateGroups csatolt tulajdonsághoz, amely a következőn FrameworkElementvan definiálva: . Bármely FrameworkElementobjektumhoz hozzáadhat VisualState objektumokat, de általában egy adott Controlobjektumban ControlTemplate használják őket. A meglévő vezérlőkhöz tartozó objektumok és VisualState objektumok létrehozásáról ControlTemplate a Vezérlők sablonjának létrehozása című témakörben olvashat. Ha például egy objektumot használ VisualState egy ControlTemplateadott objektumon kívül, tekintse meg az osztályt VisualStateManager .

Konstruktorok

Name	Description
VisualState()	Inicializálja a VisualState osztály új példányát.

Tulajdonságok

Name	Description
DependencyObjectType	Lekéri a DependencyObjectType példány CLR-típusát körbefuttatót. (Öröklődés forrása DependencyObject)
Dispatcher	Lekérdezi, Dispatcher hogy ez a társítva van-e DispatcherObject . (Öröklődés forrása DispatcherObject)
IsSealed	Olyan értéket kap, amely jelzi, hogy a példány jelenleg zárolva van-e (írásvédett). (Öröklődés forrása DependencyObject)
Name	Lekéri vagy beállítja a VisualStatenevét.
Storyboard	Lekéri vagy beállítja Storyboard azt a vezérlőt, amely meghatározza a vezérlőelem megjelenését, ha a vezérlőelem az által VisualStateképviselt állapotban van.

Metódusok

Name	Description
CheckAccess()	Meghatározza, hogy a hívó szál hozzáfér-e ehhez DispatcherObject. (Öröklődés forrása DispatcherObject)
ClearValue(DependencyProperty)	Törli egy tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyProperty azonosító határozza meg. (Öröklődés forrása DependencyObject)
ClearValue(DependencyPropertyKey)	Törli egy írásvédett tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyPropertyKey. (Öröklődés forrása DependencyObject)
CoerceValue(DependencyProperty)	A megadott függőségi tulajdonság értékét kényszeríti. Ez úgy érhető el, hogy meghívja a függőségi tulajdonság tulajdonság metaadataiban megadott függvényeket CoerceValueCallback a hívás DependencyObjectsorán. (Öröklődés forrása DependencyObject)
Equals(Object)	Meghatározza, hogy a megadott DependencyObject érték megegyezik-e az aktuális DependencyObjectértékével. (Öröklődés forrása DependencyObject)
GetHashCode()	Ehhez lekéri a DependencyObjectkivonatkódot. (Öröklődés forrása DependencyObject)
GetLocalValueEnumerator()	Létrehoz egy speciális enumerátort annak meghatározásához, hogy mely függőségi tulajdonságok rendelkeznek helyileg beállított értékekkel.DependencyObject (Öröklődés forrása DependencyObject)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValue(DependencyProperty)	Egy függőségi tulajdonság aktuális tényleges értékét adja vissza az adott példányon DependencyObject. (Öröklődés forrása DependencyObject)
InvalidateProperty(DependencyProperty)	Újra kiértékeli a megadott függőségi tulajdonság tényleges értékét. (Öröklődés forrása DependencyObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Akkor hívjuk meg, ha az adott DependencyObject függőségi tulajdonság tényleges értéke frissült. A módosított függőségi tulajdonságot az eseményadatok jelentik. (Öröklődés forrása DependencyObject)
ReadLocalValue(DependencyProperty)	Egy függőségi tulajdonság helyi értékét adja vissza, ha létezik. (Öröklődés forrása DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság értékét az értékforrás módosítása nélkül. (Öröklődés forrása DependencyObject)
SetValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság helyi értékét, amelyet a függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject)
SetValue(DependencyPropertyKey, Object)	Beállítja egy írásvédett függőség tulajdonság helyi értékét, amelyet a DependencyPropertyKey függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Olyan értéket ad vissza, amely jelzi, hogy a szerializálási folyamatok szerializálják-e a megadott függőségi tulajdonság értékét. (Öröklődés forrása DependencyObject)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
VerifyAccess()	Kényszeríti, hogy a hívószál hozzáférhessen ehhez.DispatcherObject (Öröklődés forrása DispatcherObject)