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 s názvem CommonStates a přidá VisualState objekty pro stavy, Normal, Presseda MouseOver. Button také definuje stav s názvem Disabled, který je v CommonStatesVisualStateGroup, ale příklad ho vynechá pro stručnost. Celý příklad najdete v tématu Přizpůsobení vzhledu existujícího ovládacího prvku vytvořením ovládacího prvku 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>

Poznámky

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

Vlastnost VisualStateGroup.States obsahuje VisualState objekty. VisualStateGroup objekty jsou přidány do VisualStateManager.VisualStateGroups připojené vlastnosti, která je definována na FrameworkElement. Do libovolného FrameworkElementmůžete přidat VisualState objekty, ale obvykle se používají v ControlTemplateControl. Informace o tom, jak vytvořit ControlTemplate a VisualState objekty pro existující ovládací prvky, naleznete v tématu Přizpůsobení vzhledu existujícího ovládacího prvku vytvořením controlTemplate. Příklad použití VisualState objektů mimo ControlTemplatenaleznete v VisualStateManager třídy.

Konstruktory

VisualState()

Inicializuje novou instanci VisualState třídy.

Vlastnosti

DependencyObjectType	Získá DependencyObjectType, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá Dispatcher tento 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

CheckAccess()	Určuje, zda volající vlákno má přístup k této 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 DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho lze dosáhnout vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti pro vlastnost závislost, protože existuje ve volajícím DependencyObject. (Zděděno od DependencyObject)
Equals(Object)	Určuje, zda zadaný DependencyObject odpovídá 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í vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObject. (Zděděno od DependencyObject)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject. 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)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)