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

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

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

Constructeurs

Nom	Description
VisualState()	Initialise une nouvelle instance de la classe VisualState.

Propriétés

Nom	Description
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (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 valeur qui définit l’apparence du contrôle lorsqu’il est dans l’état représenté par le VisualState.

Méthodes

Nom	Description
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (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 CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour ce 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 ce DependencyObject. (Hérité de DependencyObject)
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)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Appelé chaque fois que la valeur effective d’une propriété de dépendance sur celle-ci 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)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)