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 oggetto VisualStateGroup in di un Button oggetto denominato CommonStates e vengono aggiunti VisualState oggetti per gli stati, Normal, Pressede MouseOver.ControlTemplate Definisce Button anche uno stato denominato Disabled che si trova in CommonStatesVisualStateGroup, ma l'esempio lo omette per brevità. Per l'intero esempio, vedere Come creare un modello per un controllo .

  <!--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 oggetto specifica l'aspetto del controllo quando si trova in un determinato stato. Ad esempio, quando un Button oggetto viene premuto, il bordo potrebbe essere un colore diverso rispetto al normale. La VisualState classe ha una Storyboard proprietà che modifica l'aspetto del controllo. Quando il controllo entra nello stato specificato dalla VisualState.Name proprietà , inizia Storyboard . Quando il controllo esce dallo stato, l'oggetto Storyboard si arresta.

La VisualStateGroup.States proprietà contiene VisualState oggetti . VisualStateGroup gli oggetti vengono aggiunti alla VisualStateManager.VisualStateGroups proprietà associata, definita in su un oggetto FrameworkElement. È possibile aggiungere VisualState oggetti a qualsiasi FrameworkElementoggetto , ma in genere vengono usati in un ControlTemplate oggetto di .Control Per informazioni su come creare un oggetto ControlTemplate e VisualState per i controlli esistenti, vedere Come creare un modello per un controllo. Per un esempio di utilizzo VisualState di oggetti esterni a , ControlTemplatevedere la VisualStateManager classe .