IUIAnimationManager::SetCancelPriorityComparison-Methode (uianimation.h)

Legt den Handler für den Prioritätsvergleich fest, der aufgerufen werden soll, um zu bestimmen, ob ein geplantes Storyboard abgebrochen werden kann.

Syntax

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

Parameter

[in, optional] comparison

Der Prioritätsvergleichshandler für den Abbruch.

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 Windows-Animationsfehlercodes .

Hinweise

Durch festlegen eines Prioritätsvergleichshandlers mit dieser Methode kann die Anwendung angeben, wann Planungskonflikte durch Abbrechen von Storyboards gelöst werden können.

Ein geplantes Storyboard kann nur abgebrochen werden, wenn es nicht mit der Wiedergabe begonnen hat und das mit dieser Methode registrierte Prioritätsvergleichsobjekt S_OK zurückgibt. Abgebrochene Storyboards werden vollständig aus dem Zeitplan entfernt.

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

Anforderungen

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

Weitere Informationen

IUIAnimationManager

IUIAnimationManager::SetCompressPriorityComparison

IUIAnimationManager::SetConcludePriorityComparison

IUIAnimationManager::SetTrimPriorityComparison

IUIAnimationPriorityComparison