IUIAnimationStoryboard2::Schedule, méthode (uianimation.h)

Article
08/26/2023

Dirige le storyboard pour qu’il se planifie lui-même pour la lecture.

Syntaxe

HRESULT Schedule(
  [in]            UI_ANIMATION_SECONDS           timeNow,
  [out, optional] UI_ANIMATION_SCHEDULING_RESULT *schedulingResult
);

Paramètres

[in] timeNow

L’heure actuelle.

[out, optional] schedulingResult

Résultat de la demande de planification. Vous pouvez omettre ce paramètre des appels à cette méthode.

Valeur retournée

Retourne S_OK en cas de réussite ; sinon, un code d’erreur HRESULT . Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur d’animation Windows .

Remarques

Cette méthode indique à un storyboard d’essayer de s’ajouter à la planification de la lecture de storyboards, en utilisant les règles suivantes :

S’il n’y a pas de table de montage séquentiel qui anime les mêmes variables d’animation, la tentative réussit et le storyboard commence immédiatement à jouer.
Si le storyboard a la priorité d’annuler, de supprimer, de conclure ou de compresser les storyboards en conflit, la tentative de planification réussit et le storyboard commence à jouer dès que possible.
Si le storyboard n’a pas de priorité, la tentative échoue et le paramètre schedulingResult est défini sur UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Si cette méthode est appelée à partir d’un gestionnaire pour les événements OnStoryboardStatusChanged , le paramètre schedulingResult est défini sur UI_ANIMATION_SCHEDULING_DEFERRED. La seule façon de déterminer si le storyboard est correctement planifié consiste à définir un gestionnaire d’événements de storyboard et à case activée si le status du storyboard devient jamais UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Il est possible de réutiliser un storyboard en appelant à nouveau Schedule une fois son status atteint UI_ANIMATION_STORYBOARD_READY. Une tentative de planification d’un storyboard lorsqu’il se trouve dans un état autre que UI_ANIMATION_STORYBOARD_BUILDING ou UI_ANIMATION_STORYBOARD_READY échoue, et schedulingResult est défini sur UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED.

Configuration requise


Client minimal pris en charge	Windows 8, Windows 7 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	uianimation.h
DLL	UIAnimation.dll