IUIAnimationManager::SetConcludePriorityComparison-Methode (uianimation.h)

Legt den Prioritätsvergleichshandler fest, der aufgerufen werden soll, um zu bestimmen, ob ein geplantes Storyboard abgeschlossen werden kann.

Syntax

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

Parameter

[in, optional] comparison

Der Prioritätsvergleichshandler für die Schlussfolgerung. Das angegebene Objekt muss die IUIAnimationPriorityComparison-Schnittstelle implementieren oder NULL sein. Siehe Hinweise.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Fehlercodes für die Windows-Animation .

Hinweise

Durch Festlegen eines Prioritätsvergleichshandlers mit dieser Methode kann die Anwendung angeben, wann Planungskonflikte durch Abschluss 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 die Erinnerung an das Storyboard wird dann wiedergegeben.

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

Anforderungen

Weitere Informationen

IUIAnimationManager

IUIAnimationManager::SetCancelPriorityComparison

IUIAnimationManager::SetCompressPriorityComparison

IUIAnimationManager::SetTrimPriorityComparison

IUIAnimationPriorityComparison