Méthode IUIAnimationStoryboard ::RepeatBetweenKeyframes (uianimation.h)

Article
08/26/2023

Crée une boucle entre deux images clés spécifiées.

Syntaxe

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME startKeyframe,
  [in] UI_ANIMATION_KEYFRAME endKeyframe,
  [in] INT32                 repetitionCount
);

Paramètres

[in] startKeyframe

Image clé à laquelle la boucle doit commencer.

[in] endKeyframe

Image clé à laquelle la boucle doit se terminer. Il ne doit pas être possible pour endKeyframe de se produire plus tôt dans le storyboard que startKeyframe.

[in] repetitionCount

Nombre de fois où la boucle doit être répétée ; ce paramètre doit être 0 ou un nombre positif. Utilisez UI_ANIMATION_REPEAT_INDEFINITELY (-1) pour répéter indéfiniment la boucle jusqu’à ce que le storyboard soit rogné ou terminé.

Valeur retournée

Si la méthode réussit, retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur d’animation Windows .

Code de retour	Description
UI_E_START_KEYFRAME_AFTER_END	L’image clé de début peut se produire après l’image clé de fin.
UI_E_END_KEYFRAME_NOT_DETERMINED	Il n’est peut-être pas possible de déterminer l’heure de fin de l’image clé lorsque l’image clé de début est atteinte.
UI_E_LOOPS_OVERLAP	Deux parties répétées d’un storyboard peuvent se chevaucher.

Remarques

Cette méthode permet à un storyboard de lire l’intervalle entre les images clés données à plusieurs reprises avant de lire le reste du storyboard. Si un nombre de répétitions fini est spécifié, la boucle lit toujours ce nombre de fois. Si UI_ANIMATION_REPEAT_INDEFINITELY (-1) est spécifié, la boucle se répète jusqu’à ce que le storyboard soit terminé, auquel cas l’itération actuelle de la boucle se termine et le reste du storyboard est lu. Un storyboard qui boucle indéfiniment se termine également s’il est tronqué.

Les boucles imbriquées et qui se chevauchent ne sont pas prises en charge.

Une image clé représente un moment dans le temps dans un storyboard et peut être utilisée pour spécifier les heures de début ou de fin des transitions. Étant donné que les images clés peuvent être ajoutées à la fin des transitions, leurs décalages par rapport au début du storyboard peuvent ne pas être connus tant que le storyboard n’est pas en cours de lecture.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista et Mise à jour de plateforme pour Windows Vista [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

Voir aussi

IUIAnimationStoryboard

IUIAnimationStoryboard ::AddKeyframeAfterTransition

IUIAnimationStoryboard ::AddKeyframeAtOffset

Partager via