Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase VisualState

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)


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

NombreDescripción
System_CAPS_pubmethodVisualState()

Inicializa una nueva instancia de la clase VisualState.

NombreDescripción
System_CAPS_pubpropertyDependencyObjectType

Obtiene el DependencyObjectType que ajusta el CLR tipo de esta instancia. (Heredado de DependencyObject).

System_CAPS_pubpropertyDispatcher

Obtiene el Dispatcher Esto DispatcherObject está asociado.(Heredado de DispatcherObject).

System_CAPS_pubpropertyIsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (sólo lectura).(Heredado de DependencyObject).

System_CAPS_pubpropertyName

Obtiene o establece el nombre de VisualState.

System_CAPS_pubpropertyStoryboard

Obtiene o establece un Storyboard que define la apariencia del control cuando se encuentra en el estado representado por la VisualState.

NombreDescripción
System_CAPS_pubmethodCheckAccess()

Determina si el subproceso de llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

System_CAPS_pubmethodClearValue(DependencyProperty)

Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.(Heredado de DependencyObject).

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.(Heredado de DependencyObject).

System_CAPS_pubmethodCoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.(Heredado de DependencyObject).

System_CAPS_pubmethodEquals(Object)

Determina si un proporcionado DependencyObject es equivalente a la actual DependencyObject.(Heredado de DependencyObject).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Obtiene un código hash de este objeto DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodGetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en este DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada(Heredado de DependencyObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento.(Heredado de DependencyObject).

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.(Heredado de DependencyObject).

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.(Heredado de DependencyObject).

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.(Heredado de DependencyObject).

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.(Heredado de DependencyObject).

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia suministrada.(Heredado de DependencyObject).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

System_CAPS_pubmethodVerifyAccess()

Exige que el subproceso que realiza la llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

A VisualState especifica el aspecto del control cuando se encuentra en un estado determinado. Por ejemplo, cuando un Button está presionado, sus bordes pueden ser de un color distinto al habitual. La VisualState clase tiene un Storyboard propiedad que cambia la apariencia del control. Cuando el control entra en el estado especificado por la VisualState.Name propiedad, el Storyboard comienza. Cuando el control sale del estado, el Storyboard se detiene.

El VisualStateGroup.States contiene la propiedad VisualState objetos. VisualStateGroup se agregan objetos a la VisualStateManager.VisualStateGroups propiedad adjunta, que se define en el de un FrameworkElement. Puede agregar VisualState objetos a cualquier FrameworkElement, pero normalmente se utilizan en un ControlTemplate de un Control. Para obtener información sobre cómo crear un ControlTemplate y VisualState los objetos para los controles existentes, vea Personalizar la apariencia de un Control existente creando una clase ControlTemplate. Para obtener un ejemplo del uso de VisualState objetos fuera de un ControlTemplate, consulte la VisualStateManager clase.

En el ejemplo siguiente se crea un VisualStateGroup en la ControlTemplate de un Button llamado CommonStates y agrega VisualState objetos para los Estados, Normal, Pressed, y MouseOver. El Button también define un estado llamado Disabled que se encuentra en la CommonStatesVisualStateGroup, pero omite en el ejemplo para mayor brevedad. Para obtener el ejemplo completo, vea Personalizar la apariencia de un Control existente creando una clase 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
Disponible desde 4.0
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: