Partage via


Storyboard.GetCurrentState Méthode

Définition

Obtient l’état de l’horloge du Storyboard.

public:
 virtual ClockState GetCurrentState() = GetCurrentState;
ClockState GetCurrentState();
public ClockState GetCurrentState();
function getCurrentState()
Public Function GetCurrentState () As ClockState

Retours

Une des valeurs de l'énumération. Peut être : Actif, Remplissage ou Arrêté.

Remarques

Cette méthode est utile si vous souhaitez modifier les propriétés d’une animation au moment de l’exécution, avant le démarrage de l’animation. Une animation arrêtée (GetCurrentState renvoie ClockState.Stopped) peut toujours être modifiée. Une animation en cours d’exécution (GetCurrentState renvoie ClockState.Active ou ClockState.Filling) ne peut pas être modifiée, et vous obtiendrez une erreur si vous essayez.

Remarques pour les versions précédentes

Windows 8

Une animation peut avoir une valeur BeginTime facultative, qui modifie le moment où l’animation commence réellement à affecter les valeurs par rapport au démarrage du storyboard de contrôle. Même si l’heure d’exécution n’a pas encore atteint le BeginTime , il est illégal de modifier les propriétés de l’animation une fois que le storyboard l’a démarrée. Par Windows 8, l’appel de GetCurrentState pour une animation en cours d’exécution où l’heure d’exécution n’a pas atteint la valeur BeginTime renvoie toujours ClockState.Stopped. Normalement, il est légal de modifier les propriétés d’une animation arrêtée , mais dans ce cas particulier, ce n’est pas le cas. Par conséquent, l’utilisation de GetCurrentState pour déterminer s’il est légal de modifier l’animation n’est pas toujours exacte. À compter de Windows 8.1, l’appel de GetCurrentState pour une animation démarrée par son storyboard renvoie toujours ClockState.Active, même si la valeur BeginTime existe et n’a pas été atteinte. Les circonstances dans lesquelles GetCurrentState retourne ClockState.Filling restent les mêmes.

Les applications qui ont été compilées pour Windows 8, mais qui sont exécutées dans Windows 8.1, continuent d’appliquer le comportement Windows 8.

S’applique à

Voir aussi