VisualState Classe

Definizione

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

Proprietà

Metodi

Si applica a