Méthode IUIAnimationManager ::SetCompressPriorityComparison (uianimation.h)

Article
03/06/2024

Définit le gestionnaire de comparaison de priorité à appeler pour déterminer si un storyboard planifié peut être compressé.

Syntaxe

HRESULT SetCompressPriorityComparison(
  [in, optional] IUIAnimationPriorityComparison *comparison
);

Paramètres

[in, optional] comparison

Gestionnaire de comparaison de priorité pour la compression.

L’objet spécifié doit implémenter l’interface IUIAnimationPriorityComparison ou avoir la valeur NULL. Consultez la section Notes.

Valeur de retour

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

La définition d’un gestionnaire de comparaison de priorités avec cette méthode permet à l’application d’indiquer quand les conflits de planification peuvent être résolus en compressant le storyboard planifié et tout autre storyboard animant les mêmes variables.

Un storyboard peut être compressé uniquement si l’objet de comparaison de priorité inscrit avec cette méthode retourne S_OK pour tous les autres storyboards planifiés qui seront affectés par la compression. Lorsque les storyboards sont compressés, le temps est temporairement accéléré pour les storyboards affectés, afin qu’ils soient plus rapides.

Le passage de la valeur NULL pour le paramètre de comparaison entraîne la libération de la référence de l’animation Windows à n’importe quel objet gestionnaire que vous avez passé précédemment. Cette technique peut être essentielle pour rompre les cycles de référence sans avoir à appeler la méthode IUIAnimationManager ::Shutdown .

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