IUIAnimationManager2::SetConcludePriorityComparison-Methode (uianimation.h)

Artikel
03/03/2024

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

Syntax

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

Parameter

[in, optional] comparison

Der Prioritätsvergleichshandler für den Abschluss. 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 festlegen eines Prioritätsvergleichshandlers mit dieser Methode kann die Anwendung angeben, wann Planungskonflikte durch Abschließen des geplanten Storyboards gelöst werden können.

Ein geplantes Storyboard kann nur abgeschlossen werden, wenn es eine Schleife mit einer Wiederholungsanzahl von UI_ANIMATION_REPEAT_INDEFINITELY enthält und das mit dieser Methode registrierte Prioritätsvergleichsobjekt S_OK zurückgibt. Wenn das Storyboard abgeschlossen ist, wird die aktuelle Wiederholung der Schleife abgeschlossen, und der Rest des Storyboards wird dann wiedergegeben.

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