VisualState.Name VisualState.Name VisualState.Name VisualState.Name Property

Definición

Obtiene o establece el nombre de VisualState.Gets or sets the name of the 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

Nombre del objeto VisualState.The name of the VisualState.

Ejemplos

En el ejemplo siguiente se VisualStateGroup crea un ControlTemplate objeto en Button la CommonStates de una VisualState llamada y se agregan objetos Pressedpara los MouseOverEstados, Normal, y.The following example creates a VisualStateGroup in the ControlTemplate of a Button called CommonStates and adds VisualState objects for the states, Normal, Pressed, and MouseOver. También define un estado llamado Disabled que se encuentra en CommonStates VisualStateGroup, pero el ejemplo lo omite por motivos de brevedad. ButtonThe Button also defines a state called Disabled that is in the CommonStatesVisualStateGroup, but the example omits it for brevity. Para ver el ejemplo completo, vea personalizar la apariencia de un control existente mediante la creación de un ControlTemplate.For the entire example, see Customizing the Appearance of an Existing Control by Creating a 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 qué estado visual debe especificar un elemento pasando el Name VisualState de a VisualStateManager.You specify which visual state an element should enter by passing the Name of the VisualState to the VisualStateManager.

Cuando un Control usa el VisualStateManager en un ControlTemplate, el autor del control debe especificar VisualState qué objetos espera encontrar TemplateVisualStateAttribute el control en ControlTemplate su signatura de clase.When a Control uses the VisualStateManager in a ControlTemplate, the control author should specify which VisualState objects the control expects to find in its ControlTemplate by putting the TemplateVisualStateAttribute on its class signature. ControlTemplatelos autores definen VisualState los nuevos objetos y Name establecen la propiedad en el valor especificado TemplateVisualStateAttribute.Name por la propiedad.ControlTemplate authors define new VisualState objects and set the Name property to the value specified by the TemplateVisualStateAttribute.Name property.

Para buscar los nombres de los Estados visuales de los controles que se incluyen con WPFWPF, consulte estilos y plantillas de control.To find the names of the visual states for the controls that are included with WPFWPF, see Control Styles and Templates. Para obtener información sobre cómo crear un ControlTemplate objeto VisualState y para los controles existentes, vea personalizar la apariencia de un control existente mediante la creación de una ControlTemplate.For information about how to create a ControlTemplate and VisualState objects for existing controls, see Customizing the Appearance of an Existing Control by Creating a ControlTemplate.

Se aplica a