VisualState.Name Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit le nom de l'objet 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 de l'objet VisualState.

Exemples

L’exemple suivant crée un VisualStateGroup élément dans un Button ControlTemplate objet appelé CommonStates et ajoute VisualState des objets pour les états, Normal, Pressedet MouseOver. Il Button définit également un état appelé Disabled dans le CommonStates VisualStateGroup, 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 un ContrôleTemplate.

  <!--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 Name VisualState VisualStateManager.

Lorsqu’un Control utilise l’objet VisualStateManager dans un ControlTemplate, l’auteur du contrôle doit spécifier quels VisualState objets 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 de contrôle et modèles. Pour plus d’informations sur la création d’un ControlTemplate contrôle et VisualState d’objets pour les contrôles existants, consultez Personnalisation de l’apparence d’un contrôle existant en créant un ContrôleTemplate.