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 objet appelé ControlTemplateCommonStatesButton et ajoute des VisualState objets pour les états, Normal, Pressedet .MouseOver Il Button définit également un état appelé Disabled dans le CommonStatesVisualStateGroup, mais l’exemple l’omet pour la concision. Pour l’ensemble de l’exemple, consultez Comment créer un modèle pour un contrôle.

  <!--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 le NameVisualStateVisualStateManager.

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

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