VisualState Classe
TOC
Comprimi il sommario
Espandi il sommario
Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe VisualState

 

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

Spazio dei nomi:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)


[ContentPropertyAttribute("Storyboard")]
[RuntimeNamePropertyAttribute("Name")]
public class VisualState : DependencyObject

NomeDescrizione
System_CAPS_pubmethodVisualState()

Inizializza una nuova istanza della classe VisualState.

NomeDescrizione
System_CAPS_pubpropertyDependencyObjectType

Ottiene il DependencyObjectType che esegue il wrapping CLR del tipo dell'istanza. (Ereditato da DependencyObject.)

System_CAPS_pubpropertyDispatcher

Ottiene l'oggetto Dispatcher al quale l'oggetto DispatcherObject è associato. (Ereditato da DispatcherObject.)

System_CAPS_pubpropertyIsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).(Ereditato da DependencyObject.)

System_CAPS_pubpropertyName

Ottiene o imposta il nome dell'oggetto VisualState.

System_CAPS_pubpropertyStoryboard

Ottiene o imposta un oggetto Storyboard che definisce l'aspetto del controllo quando questo è nello stato rappresentato dall'oggetto VisualState.

NomeDescrizione
System_CAPS_pubmethodCheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObject. (Ereditato da DispatcherObject.)

System_CAPS_pubmethodClearValue(DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject.)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.La proprietà da cancellare è indicata da un identificatore DependencyPropertyKey.(Ereditato da DependencyObject.)

System_CAPS_pubmethodCoerceValue(DependencyProperty)

Assegna il valore della proprietà di dipendenza specificata.Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza, esistente nell'oggetto DependencyObject chiamante.(Ereditato da DependencyObject.)

System_CAPS_pubmethodEquals(Object)

Determina se il DependencyObject fornito equivale al DependencyObject corrente. (Ereditato da DependencyObject.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Ottiene un codice hash per questo oggetto DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject.)

System_CAPS_pubmethodGetType()

Ottiene il Type dell'istanza corrente. (Ereditato da Object.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject.)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.(Ereditato da DependencyObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object.)

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject è stato aggiornato.La specifica proprietà di dipendenza modificata viene indicata nei dati dell'evento.(Ereditato da DependencyObject.)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject.)

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificata dal relativo identificatore. (Ereditato da DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore della proprietà di dipendenza DependencyPropertyKey. (Ereditato da DependencyObject.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore fornito per la proprietà di dipendenza specificata. (Ereditato da DependencyObject.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodVerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObject. (Ereditato da DispatcherObject.)

Un oggetto VisualState specifica l'aspetto del controllo quando questo si trova in uno stato specifico.Quando si preme un oggetto Button, ad esempio, il bordo dell'oggetto potrebbe essere di un colore diverso rispetto al normale. La classe VisualState include una proprietà Storyboard che modifica l'aspetto del controllo.Quando il controllo assume lo stato specificato dalla proprietà VisualState.Name, Storyboard viene avviato.Quando il controllo non è più nello stato specificato, Storyboard viene interrotto.

La proprietà VisualStateGroup.States contiene oggetti VisualState.Gli oggetti VisualStateGroup vengono aggiunti alla proprietà associata VisualStateManager.VisualStateGroups, definita in un FrameworkElement.È possibile aggiungere oggetti VisualState a qualsiasi FrameworkElement, ma in genere vengono utilizzati in un ControlTemplate di un Control.Per informazioni su come creare oggetti ControlTemplate e VisualState per controlli esistenti, vedere Customizing the Appearance of an Existing Control by Creating a ControlTemplate.Per un esempio dell'utilizzo degli oggetti VisualState esterni a ControlTemplate, vedere la classe VisualStateManager.

Nell'esempio seguente viene creato un oggetto VisualStateGroup nell'oggetto ControlTemplate di un oggetto Button denominato CommonStates e vengono aggiunti oggetti VisualState per gli stati Normal, Pressed e MouseOver.L'oggetto Button definisce anche un stato denominato Disabled incluso nell'oggetto VisualStateGroupCommonStates, che nell'esempio è tuttavia omesso per motivi di brevità.Per l'esempio completo, vedere Customizing the Appearance of an Existing Control by Creating a ControlTemplate.

  <!--Define the states and transitions for the common states.
      The states in the VisualStateGroup are mutually exclusive to
      each other.-->
  <VisualStateGroup Name="CommonStates">

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.-->
    <VisualState Name="Normal" />

    <!--Change the SolidColorBrush, BorderBrush, to red when the
        mouse is over the button.-->
    <VisualState 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 Name="Pressed">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color"
                        To="Transparent"/>
      </Storyboard>
    </VisualState>

    <!--The Disabled state is omitted for brevity.-->
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

.NET Framework
Disponibile da 4.0
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0

Eventuali membri pubblici statici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Torna all'inizio
Mostra:
© 2016 Microsoft