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

Article
03/03/2024

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

Syntaxe

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

Paramètres

[in, optional] comparison

Gestionnaire de comparaison de priorités pour le découpage.

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 des conflits de planification peuvent être résolus en réduisant le storyboard planifié.

Un storyboard planifié ne peut être supprimé que si l’objet de comparaison de priorité inscrit avec cette méthode retourne S_OK. Si le nouveau storyboard supprime le storyboard planifié, le storyboard planifié ne peut plus affecter une variable une fois que le nouveau storyboard commence à animer cette variable.

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 de gestionnaire que vous avez transmis précédemment. Cette technique peut être essentielle pour briser 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