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

Article
08/26/2023

Définit le gestionnaire de comparaison de priorité qui détermine si un storyboard planifié peut être annulé.

Syntaxe

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

Paramètres

[in, optional] comparison

Gestionnaire de comparaison de priorité pour l’annulation.

L’objet spécifié doit implémenter l’interface IUIAnimationPriorityComparison2 ou avoir la valeur NULL. Pour plus d’informations, consultez Notes.

Valeur retournée

Retourne S_OK en cas de réussite ; sinon, 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 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é à jouer 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 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 de comparaison de priorité 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 IUIAnimationManager2::Shutdown .

Configuration requise


Client minimal pris en charge	Windows 8, Windows 7 et mise à jour de plateforme 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