IUIAnimationInterpolator2 ::GetDependencies, méthode (uianimation.h)

Article
08/26/2023

Pour la dimension donnée, GetDependencies récupère les aspects de l’interpolateur qui dépendent de la valeur ou de la vitesse initiale passée à la méthode IUIAnimationInterpolator2 ::SetInitialValueAndVelocity ou de la durée passée à la méthode IUIAnimationInterpolator2 ::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 cette méthode réussit, elle 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, vélocité et durée. Pour chacune de ces entrées, l’interpolateur retourne l’une des opérations suivantes :

Ou 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 qui :

Accepte une valeur finale en tant que paramètre.
Arrive toujours à un arrêt progressif à cette valeur finale.
A une durée déterminée par la différence entre la valeur finale et la valeur initiale.

Dans ce cas, l’interpolateur doit retourner UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION pour le paramètre initialValueDependencies . Elle ne doit pas retourner UI_ANIMATION_DEPENDENCY_FINAL_VALUE, car cette valeur est définie lors de la création de l’interpolateur et n’est pas affectée par la valeur initiale. De même, l’interpolateur 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 ensemble correct d’indicateurs. 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 de UI_ANIMATION_DEPENDENCY_FINAL_VALUE pour initialVelocityDependencies, l’animation Windows peut appeler SetInitialValueAndVelocity avec un paramètre de vélocité 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 8, Windows 7 et Platform Update 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

Voir aussi

IUIAnimationInterpolator2

Partager via