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

Article
03/06/2024

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

Syntaxe

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

Paramètres

[in, optional] comparison

Gestionnaire de comparaison de priorité pour la conclusion. 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é avec cette méthode permet à l’application d’indiquer quand les conflits de planification peuvent être résolus en terminant le storyboard planifié.

Un storyboard planifié ne peut être conclu que s’il contient une boucle avec un nombre de répétitions de UI_ANIMATION_REPEAT_INDEFINITELY et si l’objet de comparaison de priorité inscrit avec cette méthode retourne S_OK. Si le storyboard est terminé, la répétition actuelle de la boucle se termine et le rappel du storyboard est lu.

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