IUIAnimationManager2::SetCompressPriorityComparison-Methode (uianimation.h)

Artikel
08/26/2023

Legt den Prioritätsvergleichshandler fest, der bestimmt, ob ein geplantes Storyboard komprimiert werden kann.

Syntax

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

Parameter

[in, optional] comparison

Der Prioritätsvergleichshandler für die Komprimierung.

Das angegebene Objekt muss die IUIAnimationPriorityComparison2-Schnittstelle implementieren oder NULL sein. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein HRESULT-Fehlercode . Eine Liste der Fehlercodes finden Sie unter Windows-Animationsfehlercodes .

Hinweise

Durch das Festlegen eines Prioritätsvergleichshandlers mit dieser Methode kann die Anwendung angeben, wann Planungskonflikte gelöst werden können, indem das geplante Storyboard und alle anderen Storyboards komprimiert werden, die dieselben Variablen animieren.

Ein Storyboard kann nur komprimiert werden, wenn das mit dieser Methode registrierte Prioritätsvergleichsobjekt S_OK für alle anderen geplanten Storyboards zurückgibt, die von der Komprimierung betroffen sind. Wenn die Storyboards komprimiert werden, wird die Zeit für betroffene Storyboards vorübergehend beschleunigt, sodass sie schneller wiedergegeben werden.

Das Übergeben von NULL für den Vergleichsparameter bewirkt, dass Windows Animation den Verweis auf jedes Handlerobjekt freigibt, das Sie zuvor übergeben haben. Diese Technik kann für das Unterbrechen von Verweiszyklen unerlässlich sein, ohne die IUIAnimationManager2::Shutdown-Methode aufrufen zu müssen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8, Windows 7 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	uianimation.h
DLL	UIAnimation.dll