VisualState Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Représente l’apparence visuelle du contrôle lorsqu’il est dans un état spécifique.

public ref class VisualState : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("Storyboard")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualState : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("Storyboard")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualState = class
    inherit DependencyObject

Public Class VisualState
Inherits DependencyObject

Héritage

Object

DispatcherObject

DependencyObject

VisualState

Attributs

ContentPropertyAttribute RuntimeNamePropertyAttribute

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

Une VisualState spécifie l’apparence du contrôle lorsqu’il se trouve dans un certain état. Par exemple, lorsqu’une Button est enfoncée, sa bordure peut être une couleur différente de la normale. La classe VisualState a une propriété Storyboard qui modifie l’apparence du contrôle. Lorsque le contrôle entre dans l’état spécifié par la propriété VisualState.Name, le Storyboard commence. Lorsque le contrôle quitte l’état, la Storyboard s’arrête.

La propriété VisualStateGroup.States contient des objets VisualState. VisualStateGroup objets sont ajoutés à la propriété jointe VisualStateManager.VisualStateGroups, définie sur le FrameworkElement. Vous pouvez ajouter des objets VisualState à n’importe quelle FrameworkElement, mais ils sont généralement utilisés dans un ControlTemplate d’un Control. 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 . Pour obtenir un exemple d’utilisation d’objets VisualState en dehors d’un ControlTemplate, consultez la classe VisualStateManager.

Constructeurs

VisualState()

Initialise une nouvelle instance de la classe VisualState.

Propriétés

DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient la Dispatcher cette DispatcherObject est associée. (Hérité de DispatcherObject)
IsSealed	Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject)
Name	Obtient ou définit le nom du VisualState.
Storyboard	Obtient ou définit une Storyboard qui définit l’apparence du contrôle lorsqu’il se trouve dans l’état représenté par l'VisualState.

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObjectappelant. (Hérité de DependencyObject)
Equals(Object)	Détermine si une DependencyObject fournie équivaut à la DependencyObjectactuelle. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour cette DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur cette DependencyObject. (Hérité de DependencyObject)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Appelée chaque fois que la valeur effective d’une propriété de dépendance sur cette DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)