VisualState.Name Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Obtiene o establece el nombre del VisualState.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

Valor de propiedad

String

Nombre del VisualState.

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

Especifique el estado visual que debe especificar un elemento pasando el Name del VisualState al VisualStateManager.

Cuando un Control usa el VisualStateManager en un ControlTemplate, el autor del control debe especificar qué VisualState objetos que el control espera encontrar en su ControlTemplate colocando el TemplateVisualStateAttribute en su firma de clase. ControlTemplate autores definen nuevos objetos VisualState y establecen la propiedad Name en el valor especificado por la propiedad TemplateVisualStateAttribute.Name.

Para buscar los nombres de los estados visuales de los controles que se incluyen con WPF, vea Estilos de control y plantillas. 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.