IUIAnimationManager2::SetCancelPriorityComparison-Methode (uianimation.h)

Artikel
08/26/2023

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

Syntax

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

Parameter

[in, optional] comparison

Der Prioritätsvergleichshandler für den Abbruch.

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 Fehlercodes für die Windows-Animation .

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 führt dazu, 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 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