VisualState Class

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

Héritage

Object
  DependencyObject
    VisualState

Syntaxe


public sealed class VisualState : DependencyObject

Attributs

ActivatableAttribute(NTDDI_WIN8)
ContentPropertyAttribute()
MarshalingBehaviorAttribute(Agile)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)
WebHostHiddenAttribute()

Membres

VisualStateClasse comporte les types de membres suivants :

Constructeurs

VisualStateClasse comporte les constructeurs suivants.

ConstructeurDescription
VisualState Initializes a new instance of the VisualState class.

 

Méthodes

The VisualState Classe comporte les méthodes suivantes. Il hérite également des méthodes de Object Classe.

MéthodeDescription
ClearValue Clears the local value of a dependency property. (Hérité de DependencyObject)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Hérité de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Hérité de DependencyObject)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Hérité de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Hérité de DependencyObject)

 

Propriétés

Le VisualStateClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Dispatcher

en lecture seuleGets the CoreDispatcher that this object is associated with. (Hérité de DependencyObject)

Name

en lecture seuleGets the name of the VisualState.

Storyboard

en lecture/écritureGets or sets a Storyboard that defines state-specific property values and appearance of the control when it is using this visual state.

 

Exemples

Cet exemple crée un VisualStateGroup dans le ControlTemplate d'un Button appelé "CommonStates" et ajoute des objets VisualState pour les états "Normal", "Pressed", et "PointerOver". Button définit également un état appelé "Disabled" qui se trouve dans le "CommonStates" nommé VisualStateGroup, mais l'exemple l'omet pour des raisons de concision.


<ControlTemplate TargetType="Button">
  <Border x:Name="RootElement">

    <VisualStateManager.VisualStateGroups>

      <!--Define the states 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
            Pointer is over the button.-->
        <VisualState x:Name="PointerOver">
          <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>
    

    <Border.Background>
      <SolidColorBrush x:Name="BorderBrush" Color="Black"/>
    </Border.Background>

    <Grid Background="{TemplateBinding Background}" Margin="4">
      <ContentPresenter
        HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
        VerticalAlignment="{TemplateBinding VerticalContentAlignment}"
        Margin="4,5,4,4" />

    </Grid>


  </Border>
</ControlTemplate>


Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store uniquement]

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

DependencyObject

 

 

Afficher:
© 2014 Microsoft