VisualState.Name Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Obtiene o establece el nombre de 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 objeto VisualState.

Ejemplos

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

Para especificar el estado visual que debe especificar un elemento, pase el Name de VisualState a .VisualStateManager

Cuando usa Control VisualStateManager en , ControlTemplateel autor del control debe especificar los objetos que VisualState el control espera encontrar en su ControlTemplate colocación TemplateVisualStateAttribute en su firma de clase. ControlTemplate los autores definen nuevos VisualState objetos y establecen la Name propiedad en el valor especificado por la TemplateVisualStateAttribute.Name propiedad .

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 una clase ControlTemplate.