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

El nombre del VisualState.

Ejemplos

En el ejemplo siguiente se crea un VisualStateGroup en de ControlTemplate un Button objeto denominado CommonStates y se agregan VisualState objetos para los estados, Normal, Pressedy MouseOver. Button También define un estado denominado Disabled que está en , CommonStatesVisualStateGrouppero el ejemplo lo omite para mayor brevedad. Para obtener el ejemplo completo, consulte How to create a template for a control (Cómo crear una plantilla para un control).

  <!--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 un Control usa en VisualStateManager , 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 y plantillas de control. Para obtener información sobre cómo crear un objeto ControlTemplate y VisualState para los controles existentes, vea Cómo crear una plantilla para un control.