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

Article
08/26/2023

Ajoute une transition entre deux images clés.

Syntaxe

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *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 que l’image endKeyframe apparaisse plus tôt dans le storyboard que startKeyframe.

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_TRANSITION_ALREADY_USED	Cette transition a déjà été ajoutée à un storyboard ou a été ajoutée à un storyboard qui a fini de jouer et 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.

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


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