VisualState Classe

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Rappresenta l'aspetto visivo del controllo quando si trova in uno stato specifico.

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

Ereditarietà

Object

DispatcherObject

DependencyObject

VisualState

Attributi

ContentPropertyAttribute RuntimeNamePropertyAttribute

Esempio

Nell'esempio seguente viene creato un VisualStateGroup nella ControlTemplate di una Button denominata CommonStates e vengono aggiunti oggetti VisualState per gli stati, Normal, Pressede MouseOver. Il Button definisce anche uno stato denominato Disabled che si trova nel CommonStatesVisualStateGroup, ma l'esempio lo omette per brevità. Per l'intero esempio, vedere Personalizzazione dell'aspetto di un controllo esistente creando un oggetto 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>

Commenti

Un VisualState specifica l'aspetto del controllo quando si trova in un determinato stato. Ad esempio, quando viene premuto un Button, il bordo potrebbe essere un colore diverso rispetto al normale. La classe VisualState dispone di una proprietà Storyboard che modifica l'aspetto del controllo. Quando il controllo immette lo stato specificato dalla proprietà VisualState.Name, inizia il Storyboard. Quando il controllo esce dallo stato, il Storyboard si arresta.

La proprietà VisualStateGroup.States contiene oggetti VisualState. VisualStateGroup oggetti vengono aggiunti alla proprietà associata VisualStateManager.VisualStateGroups, definita in su un FrameworkElement. È possibile aggiungere oggetti VisualState a qualsiasi FrameworkElement, ma in genere vengono usati in un ControlTemplate di un Control. Per informazioni su come creare un ControlTemplate e oggetti VisualState per i controlli esistenti, vedere Personalizzazione dell'aspetto di un controllo esistente mediante la creazione di un controllo ControlTemplate. Per un esempio di utilizzo di oggetti VisualState all'esterno di un ControlTemplate, vedere la classe VisualStateManager.

Costruttori

VisualState()

Inizializza una nuova istanza della classe VisualState.

Proprietà

DependencyObjectType	Ottiene il DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene il Dispatcher a cui è associato questo DispatcherObject. (Ereditato da DispatcherObject)
IsSealed	Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject)
Name	Ottiene o imposta il nome del VisualState.
Storyboard	Ottiene o imposta un Storyboard che definisce l'aspetto del controllo quando si trova nello stato rappresentato dal VisualState.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a questo DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un identificatore di DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Forza il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati delle proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObject. (Ereditato da DependencyObject)
Equals(Object)	Determina se un DependencyObject specificato è equivalente all'DependencyObjectcorrente. (Ereditato da DependencyObject)
GetHashCode()	Ottiene un codice hash per questo DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObject. (Ereditato da DependencyObject)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata nei dati dell'evento. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a questo DispatcherObject. (Ereditato da DispatcherObject)