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 a seguir cria um Rectangle nome e adiciona um VisualStateGroup nome CommonStates à VisualStateManager.VisualStatesGroups propriedade anexada. O exemplo define os objetos e Normalos objetos noVisualStateGroupCommonStates .MouseOverVisualState Quando o usuário move o ponteiro do mouse sobre o Rectangle, ele muda de vermelho para verde em mais de meio segundo. Quando o usuário move o mouse para longe do retângulo, as Grid alterações imediatamente voltam para vermelho. Observe que o Normal estado não define um Storyboard. Um Storyboard não é necessá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 retorno para 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 a seguir mostra o manipulador de eventos definido no exemplo anterior e chama o GoToElementState método para fazer a transição entre estados. Se o retângulo no exemplo anterior fosse parte de um ControlTemplate, o exemplo teria que 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

Comentários

Permite VisualStateManager que você especifique estados para um controle, a aparência de um controle quando ele está em um determinado estado e quando um controle muda de estado. Por exemplo, um Button pode ter uma aparência ligeiramente diferente quando é pressionado do que quando não é pressionado. Dois estados aos quais as Button definições correspondem quando ela é pressionada ("Pressed") e quando não é ("Normal"). A aparência de um controle quando ele está em um estado é definido por um VisualState. Um VisualState contém uma coleção de Storyboard objetos que especificam como a aparência do controle é alterada quando o controle está nesse estado. Adicione estados visuais a um controle definindo a VisualStateManager.VisualStateGroups propriedade anexada no controle. Cada VisualStateGroup um contém uma coleção de VisualState objetos que são mutuamente exclusivos. Ou seja, o controle está sempre em exatamente um estado de cada VisualStateGroup.

O VisualStateManager também permite que você especifique quando um controle entra em um estado específico. O método que você deve chamar para alterar estados depende do seu cenário. Se você criar um controle que usa o VisualStateManager método ControlTemplate, chame o GoToState método. Para obter mais informações sobre como criar controles que usam o VisualStateManager, consulte Criando um controle que tem uma aparência personalizável. Se você usar o VisualStateManager exterior de um ControlTemplate (por exemplo, se você usar um VisualStateManager em um UserControl ou em um único elemento), chame o GoToElementState método. Em ambos os casos, executa a VisualStateManager lógica necessária para iniciar e parar adequadamente os storyboards associados ao estado envolvido. Por exemplo, suponha que um controle defina os estados eState2, State1 cada um deles, tenha um storyboard associado a ele. Se o controle estiver dentro State1 e você passar State2 para GoToState ou GoToElementState, o VisualStateManager storyboard State2 iniciará e interromperá o storyboard em State1.

Os controles incluídos no WPF (Windows Presentation Foundation) usam os VisualStateManager estados visuais para alterar. Quando você cria um ControlTemplate controle que está incluído no WPF, você pode adicionar VisualState objetos aos controles ControlTemplate para especificar a aparência do controle em um determinado estado. Para localizar os nomes dos estados visuais para os controles incluídos no WPF, consulte Estilos de controle e modelos. A lógica do controle manipula a transição entre estados, portanto, você não precisa fazer nada além de definir os VisualState objetos no novo ControlTemplate. Para obter mais informações sobre como criar modelos de controle para controles existentes, consulte Como criar um modelo para um controle.

Se você quiser implementar sua própria lógica para a transição entre estados, você deverá herdar VisualStateManager, substituir o GoToStateCore método e definir a VisualStateManager.CustomVisualStateManager propriedade anexada no controle que usa a lógica personalizada.