VisualStateManager.GoToState(FrameworkElement, String, Boolean) Método

Definição

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Faz a transição do controle entre dois estados. Use esse método para fazer a transição de estados no controle que tem um ControlTemplate.

public:
 static bool GoToState(System::Windows::FrameworkElement ^ control, System::String ^ stateName, bool useTransitions);
public static bool GoToState(System.Windows.FrameworkElement control, string stateName, bool useTransitions);
static member GoToState : System.Windows.FrameworkElement * string * bool -> bool
Public Shared Function GoToState (control As FrameworkElement, stateName As String, useTransitions As Boolean) As Boolean

Parâmetros

control
FrameworkElement

O controle para a transição entre estados.

stateName
String

O estado para o qual fazer a transição.

useTransitions
Boolean

true para usar um VisualTransition objeto para fazer a transição entre estados; caso contrário, false.

Retornos

Boolean

true se o controle tiver sido transferido com êxito para o novo estado; caso contrário, false.

Exceções

ArgumentNullException

control é null.

-ou-

stateName é null.

Exemplos

O exemplo a seguir demonstra um controle que usa o GoToState método para fazer a transição entre estados. Para o exemplo inteiro, consulte Criando um controle que tem uma aparência personalizável.

private void UpdateStates(bool useTransitions)
{
    if (Value >= 0)
    {
        VisualStateManager.GoToState(this, "Positive", useTransitions);
    }
    else
    {
        VisualStateManager.GoToState(this, "Negative", useTransitions);
    }

    if (IsFocused)
    {
        VisualStateManager.GoToState(this, "Focused", useTransitions);
    }
    else
    {
        VisualStateManager.GoToState(this, "Unfocused", useTransitions);
    }
}

Private Sub UpdateStates(ByVal useTransitions As Boolean)

    If Value >= 0 Then
        VisualStateManager.GoToState(Me, "Positive", useTransitions)
    Else
        VisualStateManager.GoToState(Me, "Negative", useTransitions)
    End If

    If IsFocused Then
        VisualStateManager.GoToState(Me, "Focused", useTransitions)
    Else
        VisualStateManager.GoToState(Me, "Unfocused", useTransitions)

    End If
End Sub

Comentários

Chame o GoToState método se você estiver alterando estados em um controle que usa o VisualStateManager em seu ControlTemplate. Chame o GoToElementState método para alterar estados em um elemento fora de um ControlTemplate (por exemplo, se você usar um VisualStateManager em um UserControl ou em um único elemento).

Aplica-se a