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

Article
03/06/2024

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

Syntaxe

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

Paramètres

[in, optional] comparison

Gestionnaire de comparaison de priorités pour l’annulation.

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 annulant les storyboards.

Un storyboard planifié ne peut être annulé que s’il n’a pas commencé à lire et si l’objet de comparaison de priorité inscrit avec cette méthode retourne S_OK. Les storyboards annulés sont complètement supprimés de la planification.

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 de comparaison de priorité que vous avez passé 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