VisualState Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Representa la apariencia visual del control cuando se encuentra en un estado específico.

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

VisualState()

Inicializa una nueva instancia de la clase VisualState.

Propiedades

DependencyObjectType	Obtiene el DependencyObjectType que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el Dispatcher al que está asociado este DispatcherObject. (Heredado de DispatcherObject)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura). (Heredado de DependencyObject)
Name	Obtiene o establece el nombre del VisualState.
Storyboard	Obtiene o establece un Storyboard que define la apariencia del control cuando está en el estado representado por el VisualState.

Métodos

CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. El identificador de DependencyProperty especifica la propiedad que se va a borrar. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. Un DependencyPropertyKeyespecifica la propiedad que se va a borrar. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función de CoerceValueCallback especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada a DependencyObject. (Heredado de DependencyObject)
Equals(Object)	Determina si un DependencyObject proporcionado es equivalente al DependencyObjectactual. (Heredado de DependencyObject)
GetHashCode()	Obtiene un código hash para este DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cada vez que se ha actualizado el valor efectivo de cualquier propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos del evento. (Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)