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

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Fait passer le contrôle d'un état à un autre. Utilisez cette méthode pour le changement d'état sur un contrôle qui a un 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

Paramètres

control

FrameworkElement

Contrôle à passer d'un état à l'autre.

stateName

String

État vers lequel effectuer la transition.

useTransitions

Boolean

true pour utiliser un objet VisualTransition visant à effectuer une transition entre les états ; sinon, false.

Retours

Boolean

true si le contrôle a basculé avec succès vers le nouvel état ; sinon, false.

Exceptions

ArgumentNullException

control a la valeur null.

-ou- stateName a la valeur null.

Exemples

L’exemple suivant illustre un contrôle qui utilise la méthode pour passer d’un GoToState état à l’autre. Pour l’ensemble de l’exemple, consultez Création d’un contrôle qui a une apparence personnalisable.

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

Remarques

Appelez la GoToState méthode si vous changez d’état dans un contrôle qui utilise l’élément VisualStateManager dans son ControlTemplate. Appelez la méthode pour modifier les GoToElementState états d’un élément en dehors d’un ControlTemplate (par exemple, si vous utilisez un VisualStateManager élément dans un UserControl ou dans un seul élément).