Méthode IUIAnimationInterpolator ::GetDependencies (uianimation.h)

Article
08/26/2023

Obtient les aspects de l’interpolateur qui dépendent de la valeur ou de la vitesse initiale passée à SetInitialValueAndVelocity, ou qui dépendent de la durée passée à SetDuration.

Syntaxe

HRESULT GetDependencies(
  [out] UI_ANIMATION_DEPENDENCIES *initialValueDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *initialVelocityDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *durationDependencies
);

Paramètres

[out] initialValueDependencies

Aspects de l’interpolateur qui dépendent de la valeur initiale passée à SetInitialValueAndVelocity.

[out] initialVelocityDependencies

Aspects de l’interpolateur qui dépendent de la vitesse initiale passée à SetInitialValueAndVelocity.

[out] durationDependencies

Aspects de l’interpolateur qui dépendent de la durée passée à SetDuration.

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 .

Remarques

Cette méthode est appelée pour identifier les aspects de l’interpolateur personnalisé qui sont affectés par certaines entrées : valeur, vitesse et durée. Pour chacune de ces entrées, l’interpolateur retourne l’une des valeurs suivantes :

Or au niveau du bit de tous les membres de UI_ANIMATION_DEPENDENCIES qui s’appliquent.
UI_ANIMATION_DEPENDENCY_NONE si rien ne dépend de l’entrée.

Par exemple, considérez un interpolateur (1) qui accepte une valeur finale comme paramètre, (2) qui arrive toujours à un arrêt progressif à cette valeur finale, et (3) dont la durée est déterminée par la différence entre les valeurs finales et initiales. L’interpolateur doit retourner UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION pour initialValueDependencies. Il ne doit pas retourner UI_ANIMATION_DEPENDENCY_FINAL_VALUE , car il est défini lorsque l’interpolateur est créé et n’est pas affecté par la valeur initiale. De même, il ne doit pas retourner UI_ANIMATION_DEPENDENCY_FINAL_VELOCITY , car la pente de la courbe est définie comme étant toujours égale à zéro lorsqu’elle atteint la valeur finale.

Il est important qu’un interpolateur retourne un jeu d’indicateurs correct. Si aucun indicateur n’est présent pour une sortie, l’animation Windows suppose que le paramètre correspondant n’affecte pas cet aspect des résultats de l’interpolateur. Par exemple, si l’interpolateur personnalisé n’inclut pas UI_ANIMATION_DEPENDENCY_FINAL_VALUE pour initialVelocityDependencies, l’animation Windows peut appeler SetInitialValueAndVelocity avec un paramètre de vitesse arbitraire, puis appeler GetFinalValue pour déterminer la valeur finale. L’implémentation de GetFinalValue par l’interpolateur doit retourner le même résultat, quel que soit le paramètre de vitesse passé à SetInitialValueAndVelocity , car l’interpolateur a affirmé que la valeur finale de la transition ne dépend pas de la vitesse initiale.

Note Si les indicateurs retournés pour durationDependencies n’incluent pas UI_ANIMATION_DEPENDENCY_DURATION, SetDuration ne sera jamais appelé sur l’interpolateur.

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

IUIAnimationInterpolator

UI_ANIMATION_DEPENDENCIES

Partager via