VisualStateManager Classe

Definição

public ref class VisualStateManager : System::Windows::DependencyObject

public class VisualStateManager : System.Windows.DependencyObject

type VisualStateManager = class
    inherit DependencyObject

Public Class VisualStateManager
Inherits DependencyObject

Herança

Object

DispatcherObject

DependencyObject

VisualStateManager

Exemplos

O exemplo seguinte cria um Rectangle e adiciona um VisualStateGroup nome CommonStates à VisualStateManager.VisualStatesGroups propriedade anexada. O exemplo define os MouseOver objetos e NormalVisualState em .CommonStatesVisualStateGroup Quando o utilizador move o ponteiro do rato sobre o Rectangle, ele muda de vermelho para verde ao longo de meio segundo. Quando o utilizador afasta o rato do retângulo, este Grid volta imediatamente ao vermelho. Note-se que o Normal estado não define um Storyboard. A Storyboard não é obrigatório porque, quando a Rectangle transição do MouseOver estado para o Normal estado, o Storyboard for MouseOver é interrompido e a Color propriedade para o SolidColorBrush volta a vermelho.

<Rectangle Name="rect" 
           Width="100" Height="100"
           MouseEnter="rect_MouseEvent" 
           MouseLeave="rect_MouseEvent">
  <VisualStateManager.VisualStateGroups>
    <VisualStateGroup Name="MouseStates">
      <VisualState Name="MouseEnter">
        <Storyboard>
          <ColorAnimation To="Green" 
                          Storyboard.TargetName="rectBrush" 
                          Storyboard.TargetProperty="Color"/>
        </Storyboard>
      </VisualState>
      <VisualState Name="MouseLeave" />
      <VisualStateGroup.Transitions>
        <VisualTransition To="MouseLeave" GeneratedDuration="00:00:00"/>

        <VisualTransition To="MouseEnter" GeneratedDuration="00:00:00.5">
          <VisualTransition.GeneratedEasingFunction>
            <ExponentialEase EasingMode="EaseOut" Exponent="10"/>
          </VisualTransition.GeneratedEasingFunction>
        </VisualTransition>

      </VisualStateGroup.Transitions>
    </VisualStateGroup>
  </VisualStateManager.VisualStateGroups>

  <Rectangle.Fill>
    <SolidColorBrush x:Name="rectBrush" Color="Red"/>
  </Rectangle.Fill>
</Rectangle>

O exemplo seguinte mostra o handler de eventos definido no exemplo anterior e chama o GoToElementState método para a transição entre estados. Se o retângulo no exemplo anterior fizesse parte de um ControlTemplate, o exemplo teria de chamar o GoToState método.

private void rect_MouseEvent(object sender, MouseEventArgs e)
{
    if (rect.IsMouseOver)
    {
        VisualStateManager.GoToElementState(rect, "MouseEnter", true);
    }
    else
    {
        VisualStateManager.GoToElementState(rect, "MouseLeave", true);
    }
}

Private Sub rect_MouseEvent(ByVal sender As Object, ByVal e As MouseEventArgs)
    If rect.IsMouseOver Then
        VisualStateManager.GoToElementState(rect, "MouseEnter", True)
    Else
        VisualStateManager.GoToElementState(rect, "MouseLeave", True)
    End If
End Sub

Observações

Permite-lhe VisualStateManager especificar estados para um controlo, a aparência de um controlo quando está num determinado estado e quando um controlo muda de estado. Por exemplo, a Button pode ter uma aparência ligeiramente diferente quando é pressionada do que quando não é pressionada. Dois estados que os Button defines correspondem a quando é pressionado ("Pressed") e quando não é pressionado ("Normal"). A aparência de um controlo quando está num estado é definida por um VisualState. A contém uma coleção de Storyboard objetos que especificam como a aparência do controlo VisualState muda quando o controlo está nesse estado. Adiciona-se estados visuais a um controlo ao definir a VisualStateManager.VisualStateGroups propriedade associada no controlo. Cada um VisualStateGroup contém uma coleção de VisualState objetos mutuamente exclusivos. Ou seja, o controlo está sempre exatamente num estado de em cada VisualStateGroup.

Também VisualStateManager permite especificar quando um controlo entra num estado específico. A forma como deve ligar para mudar de estado depende do seu caso. Se criares um controlo que use o VisualStateManager em seu ControlTemplate, chama o GoToState método. Para mais informações sobre como criar controlos que utilizam o VisualStateManager, veja Criar um Controlo que Tem uma Aparência Personalizável. Se usares o VisualStateManager exterior de a ControlTemplate (por exemplo, se usares a VisualStateManager em a UserControl ou num único elemento), chama o GoToElementState método. Em qualquer dos casos, executa VisualStateManager a lógica necessária para iniciar e terminar adequadamente os storyboards associados ao estado envolvido. Por exemplo, suponha que um controlo define os estados, State1 e State2, cada um dos quais tem um storyboard associado. Se o controlo estiver inserido State1 e passar State2 para GoToState ou GoToElementState, o VisualStateManager storyboard começa em State2 e para o storyboard em State1.

Os controlos incluídos com Windows Presentation Foundation (WPF) usam o VisualStateManager para alterar estados visuais. Quando crias um ControlTemplate para um controlo incluído com WPF, podes adicionar objetos VisualState ao ControlTemplate do controlo para especificar a aparência do controlo num determinado estado. Para encontrar os nomes dos estados visuais dos controlos incluídos com WPF, veja Estilos e Modelos de Controlo. A lógica do controlo trata da transição entre estados, por isso não precisa de fazer nada além de definir os VisualState objetos no novo ControlTemplate. Para mais informações sobre como criar modelos de controlo para controlos existentes, consulte Como criar um modelo para um controlo.

Se quiseres implementar a tua própria lógica para transição entre estados, tens de herdar de VisualStateManager, sobrescrever o GoToStateCore método e definir a VisualStateManager.CustomVisualStateManager propriedade anexada no controlo que usa a lógica personalizada.