Méthode IUIAnimationStoryboard2 ::AddTransitionBetweenKeyframes (uianimation.h)

Article
03/03/2024

Ajoute une transition entre deux images clés.

Syntaxe

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable2   *variable,
  [in] IUIAnimationTransition2 *transition,
  [in] UI_ANIMATION_KEYFRAME   startKeyframe,
  [in] UI_ANIMATION_KEYFRAME   endKeyframe
);

Paramètres

[in] variable

Variable d’animation pour laquelle la transition doit être ajoutée.

[in] transition

Transition à ajouter.

[in] startKeyframe

Image clé qui spécifie le début de la nouvelle transition.

[in] endKeyframe

Image clé qui spécifie la fin de la nouvelle transition. Il ne doit pas être possible pour endKeyframe d’apparaître plus tôt dans le storyboard que startKeyframe.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Code de retour	Description
UI_E_TRANSITION_ALREADY_USED	Cette transition a déjà été ajoutée à un storyboard ou a été ajoutée à un storyboard qui a terminé sa lecture et qui a été publié.
UI_E_TRANSITION_ECLIPSED	La transition peut éclipser le début d’une autre transition dans le storyboard.
UI_E_START_KEYFRAME_AFTER_END	L’image clé de début peut se produire après l’image clé de fin.

Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur d’animation Windows .

Remarques

Cette méthode applique la transition spécifiée à la variable spécifiée dans le storyboard, la transition commençant et se terminant aux images clés spécifiées. Si la transition a été créée avec un paramètre de durée spécifié, cette durée est remplacée par la durée entre les images clés de début et de fin. Sinon, l’animation Windows accélère ou ralentit la transition si nécessaire.

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 et 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.

Les transitions doivent être ajoutées dans l’ordre dans lequel elles seront jouées. Une transition peut commencer à jouer avant la fin de la transition précédente dans le storyboard, auquel cas la valeur initiale et la vitesse observées par la nouvelle transition seront déterminées par l’état de la précédente. Il ne doit pas être possible qu’une transition commence avant le début de la transition précédente.

Configuration requise

Condition requise	Valeur
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