VisualState.Name Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit le nom du 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

Valeur de propriété

String

Nom du VisualState.

Exemples

L’exemple suivant crée un VisualStateGroup dans la ControlTemplate d’un Button appelé CommonStates et ajoute des objets VisualState pour les états, Normal, Pressedet MouseOver. Le Button définit également un état appelé Disabled qui se trouve dans la CommonStatesVisualStateGroup, mais l’exemple l’omet pour la concision. Pour l’ensemble de l’exemple, consultez Personnalisation de l’apparence d’un contrôle existant en créant unControlTemplate .

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

Remarques

Vous spécifiez l’état visuel qu’un élément doit entrer en passant l'Name du VisualState au VisualStateManager.

Lorsqu’un Control utilise le VisualStateManager dans un ControlTemplate, l’auteur du contrôle doit spécifier les objets VisualState que le contrôle s’attend à trouver dans son ControlTemplate en plaçant le TemplateVisualStateAttribute sur sa signature de classe. ControlTemplate auteurs définissent de nouveaux objets VisualState et définissent la propriété Name sur la valeur spécifiée par la propriété TemplateVisualStateAttribute.Name.

Pour rechercher les noms des états visuels des contrôles inclus dans WPF, consultez Styles de contrôle et modèles. Pour plus d’informations sur la création d’objets ControlTemplate et VisualState pour les contrôles existants, consultez Personnalisation de l’apparence d’un contrôle existant en créant unControlTemplate .