VisualState Třída

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Představuje vizuální vzhled ovládacího prvku, pokud je v určitém stavu.

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

Dědičnost

Object

DispatcherObject

DependencyObject

VisualState

Atributy

ContentPropertyAttribute RuntimeNamePropertyAttribute

Příklady

Následující příklad vytvoří VisualStateGroup v ControlTemplateButton volání CommonStates a přidá VisualState objekty pro stavy, Normal, , Presseda MouseOver. Také Button definuje stav, Disabled který je v CommonStatesVisualStateGroup, ale příklad vynechá ho pro stručnost. Celý příklad najdete v tématu Vytvoření šablony pro ovládací prvek.

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

Poznámky

Určuje VisualState , jak ovládací prvek vypadá, když je v určitém stavu. Když je například Button stisknuto, může být jeho ohraničení jinou barvou než normální. Třída VisualState má Storyboard vlastnost, která změní vzhled ovládacího prvku. Když ovládací prvek zadá stav, který je určen vlastností VisualState.Name , Storyboard začne. Když ovládací prvek ukončí stav, zastaví se Storyboard .

Vlastnost VisualStateGroup.States obsahuje VisualState objekty. VisualStateGroup objekty jsou přidány do VisualStateManager.VisualStateGroups připojené vlastnosti, která je definována v objektu FrameworkElement. Objekty můžete přidat VisualState do libovolného FrameworkElementobjektu , ale obvykle se používají v objektu ControlTemplateControl. Informace o tom, jak vytvořit ControlTemplate objekty VisualState pro existující ovládací prvky, naleznete v tématu Vytvoření šablony pro ovládací prvek. Příklad použití VisualState objektů mimo objekty ControlTemplate, viz VisualStateManager třída.

Konstruktory

Name	Description
VisualState()	Inicializuje novou instanci VisualState třídy.

Vlastnosti

Name	Description
DependencyObjectType	DependencyObjectType Získá ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
Name	Získá nebo nastaví název VisualState.
Storyboard	Získá nebo nastaví Storyboard , který definuje vzhled ovládacího prvku, když je ve stavu, který je reprezentován VisualState.

Metody

Name	Description
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (Zděděno od DependencyObject)
Equals(Object)	Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject. (Zděděno od DependencyObject)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní vlastnost závislosti, která se změnila, je hlášena v datech události. (Zděděno od DependencyObject)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnot. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou jeho identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)