VisualState Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Atrybuty
Przykłady
Poniższy przykład tworzy VisualStateGroup w ControlTemplateButton o nazwie CommonStates
i dodaje obiekty VisualState dla stanów, Normal
, Pressed
i MouseOver
.
Button definiuje również stan o nazwie Disabled
, który znajduje się w CommonStates
VisualStateGroup, ale przykład pomija go w celu zwięzłości. W całym przykładzie zobacz Dostosowywanie wyglądu istniejącej kontrolki przez utworzenie kontrolki 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>
Uwagi
VisualState określa, jak wygląda kontrolka w określonym stanie. Na przykład po naciśnięciu Button obramowanie może być innym kolorem niż zwykle. Klasa VisualState ma właściwość Storyboard, która zmienia wygląd kontrolki. Gdy kontrolka wprowadza stan określony przez właściwość VisualState.Name, rozpoczyna się Storyboard. Po zakończeniu działania kontrolki Storyboard zostanie zatrzymana.
Właściwość VisualStateGroup.States zawiera obiekty VisualState. VisualStateGroup obiekty są dodawane do dołączonej właściwości VisualStateManager.VisualStateGroups, która jest zdefiniowana na FrameworkElement. Obiekty VisualState można dodawać do dowolnego FrameworkElement, ale są one zwykle używane w ControlTemplateControl. Aby uzyskać informacje na temat tworzenia obiektów ControlTemplate i VisualState dla istniejących kontrolek, zobacz Dostosowywanie wyglądu istniejącej kontrolki przez utworzenie kontrolki ControlTemplate. Przykład użycia obiektów VisualState poza ControlTemplatemożna znaleźć w klasie VisualStateManager.
Konstruktory
VisualState() |
Inicjuje nowe wystąpienie klasy VisualState. |
Właściwości
DependencyObjectType |
Pobiera DependencyObjectType, który opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject) |
Dispatcher |
Pobiera Dispatcher jest skojarzony z tym DispatcherObject. (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ę VisualState. |
Storyboard |
Pobiera lub ustawia Storyboard definiujący wygląd kontrolki, gdy znajduje się w stanie reprezentowanym przez VisualState. |
Metody
CheckAccess() |
Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject. (Odziedziczone po DispatcherObject) |
ClearValue(DependencyProperty) |
Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez identyfikator DependencyProperty. (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 DependencyPropertyKey. (Odziedziczone po DependencyObject) |
CoerceValue(DependencyProperty) |
Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej funkcji CoerceValueCallback określonej w metadanych właściwości dla właściwości, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject) |
Equals(Object) |
Określa, czy podany DependencyObject jest odpowiednikiem bieżącego DependencyObject. (Odziedziczone po DependencyObject) |
GetHashCode() |
Pobiera kod skrótu dla tego 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 DependencyObject. (Odziedziczone po DependencyObject) |
GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
GetValue(DependencyProperty) |
Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia 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) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Wywoływane za każdym razem, gdy wartość efektywna dowolnej właściwości zależności na tym DependencyObject została zaktualizowana. 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śloną przez identyfikator DependencyPropertyKey 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) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
VerifyAccess() |
Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject. (Odziedziczone po DispatcherObject) |