VisualState Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Representa a aparência visual do controle quando ele está em um estado específico.

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

VisualState()

Inicializa uma nova instância da classe VisualState.

Propriedades

DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual esse DispatcherObject está associado. (Herdado de DispatcherObject)
IsSealed	Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject)
Name	Obtém ou define o nome do VisualState.
Storyboard	Obtém ou define um Storyboard que define a aparência do controle quando ele está no estado representado pelo VisualState.

Métodos

CheckAccess()	Determina se o thread de chamada tem acesso a esse DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um identificador de DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função de CoerceValueCallback especificada em metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObjectatual. (Herdado de DependencyObject)
GetHashCode()	Obtém um código hash para este DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente neste DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência neste DependencyObject for atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a esse DispatcherObject. (Herdado de DispatcherObject)