Storyboard.GetCurrentState Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient l’état de l’horloge du Storyboard.
public:
virtual ClockState GetCurrentState() = GetCurrentState;ClockState GetCurrentState();public ClockState GetCurrentState();function getCurrentState()Public Function GetCurrentState () As ClockStateRetours
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.