VisualState Classe

Definição

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

Herança

Object

DispatcherObject

DependencyObject

VisualState

Atributos

ContentPropertyAttribute RuntimeNamePropertyAttribute

Exemplos

O exemplo a seguir cria uma VisualStateGroup no ControlTemplate de um Button chamado CommonStates e adiciona objetos VisualState para os estados, Normal, Pressede MouseOver. O Button também define um estado chamado Disabled que está no CommonStatesVisualStateGroup, mas o exemplo omite-o para brevidade. Para obter todo o exemplo, consulte Personalizando a aparência de um controle existente criando umControlTemplate.

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

Comentários

Um VisualState especifica a aparência do controle quando ele está em um determinado estado. Por exemplo, quando um Button é pressionado, sua borda pode ser uma cor diferente do normal. A classe VisualState tem uma propriedade Storyboard que altera a aparência do controle. Quando o controle entra no estado especificado pela propriedade VisualState.Name, o Storyboard começa. Quando o controle sai do estado, o Storyboard é interrompido.

A propriedade VisualStateGroup.States contém objetos VisualState. VisualStateGroup objetos são adicionados à propriedade anexada VisualStateManager.VisualStateGroups, que é definida em um FrameworkElement. Você pode adicionar objetos VisualState a qualquer FrameworkElement, mas eles normalmente são usados em uma ControlTemplate de um Control. Para obter informações sobre como criar um ControlTemplate e VisualState objetos para controles existentes, consulte Personalizando a aparência de um controle existente criando umaControlTemplate. Para obter um exemplo de como usar objetos VisualState fora de uma ControlTemplate, consulte a classe VisualStateManager.

Construtores

Propriedades

Métodos

Aplica-se a