VisualState Clase

Definición

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

Herencia

Object

DispatcherObject

DependencyObject

VisualState

Atributos

ContentPropertyAttribute RuntimeNamePropertyAttribute

Ejemplos

En el ejemplo siguiente se crea un VisualStateGroup en el ControlTemplate de un Button denominado CommonStates y se agregan VisualState objetos para los estados, Normal, Pressedy MouseOver. El Button también define un estado denominado Disabled que se encuentra en el CommonStatesVisualStateGroup, pero el ejemplo lo omite por brevedad. Para obtener todo el ejemplo, vea Personalización de la apariencia de un control existente mediante la creación de un 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>

Comentarios

Un VisualState especifica el aspecto del control cuando se encuentra en un estado determinado. Por ejemplo, cuando se presiona un Button, su borde puede ser un color diferente al normal. La clase VisualState tiene una propiedad Storyboard que cambia la apariencia del control. Cuando el control entra en el estado especificado por la propiedad VisualState.Name, comienza el Storyboard. Cuando el control sale del estado, el Storyboard se detiene.

La propiedad VisualStateGroup.States contiene objetos VisualState. VisualStateGroup objetos se agregan a la propiedad adjunta VisualStateManager.VisualStateGroups, que se define en en un FrameworkElement. Puede agregar VisualState objetos a cualquier FrameworkElement, pero normalmente se usan en un ControlTemplate de un Control. Para obtener información sobre cómo crear un objeto ControlTemplate y VisualState para los controles existentes, vea Personalización de la apariencia de un control existente mediante la creación de un controlTemplate. Para obtener un ejemplo de uso de objetos VisualState fuera de un ControlTemplate, vea la clase VisualStateManager.

Constructores

Propiedades

Métodos

Se aplica a