VisualState.Name Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define o nome do 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 da propriedade

String

O nome do VisualState.

Exemplos

O exemplo a seguir cria uma VisualStateGroup no ControlTemplate de um Button chamado CommonStates e adiciona objetos VisualState para os estados, Normal, Pressede MouseOver. O Button também define um estado chamado Disabled que está no CommonStatesVisualStateGroup, mas o exemplo omite-o para brevidade. Para obter todo o exemplo, consulte Personalizando a aparência de um controle existente criando umControlTemplate.

  <!--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>

Comentários

Especifique qual estado visual um elemento deve inserir passando o Name do VisualState para o VisualStateManager.

Quando um Control usa o VisualStateManager em um ControlTemplate, o autor do controle deve especificar quais objetos VisualState o controle espera encontrar em seu ControlTemplate colocando o TemplateVisualStateAttribute em sua assinatura de classe. ControlTemplate autores definem novos objetos VisualState e definem a propriedade Name como o valor especificado pela propriedade TemplateVisualStateAttribute.Name.

Para localizar os nomes dos estados visuais para os controles incluídos no WPF, consulte estilos de controle e modelos. Para obter informações sobre como criar um ControlTemplate e VisualState objetos para controles existentes, consulte Personalizando a aparência de um controle existente criando umaControlTemplate.