IUIAnimationManager2::SetTrimPriorityComparison-Methode (uianimation.h)

Artikel
08/26/2023

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

Syntax

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

Parameter

[in, optional] comparison

Der Prioritätsvergleichshandler für das Kürzen.

Das angegebene Objekt muss die IUIAnimationPriorityComparison-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 Festlegen eines Prioritätsvergleichshandlers mit dieser Methode kann die Anwendung angeben, wann Planungskonflikte durch Kürzen des geplanten Storyboards gelöst werden können.

Ein geplantes Storyboard kann nur gekürzt werden, wenn das mit dieser Methode registrierte Prioritätsvergleichsobjekt S_OK zurückgibt. Wenn das neue Storyboard das geplante Storyboard schneidet, kann sich das geplante Storyboard nicht mehr auf eine Variable auswirken, nachdem das neue Storyboard beginnt, diese Variable zu animieren.

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


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