IUIAnimationManager2::SetCancelPriorityComparison-Methode (uianimation.h)
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 |
Weitere Informationen
IUIAnimationManager2::SetCompressPriorityComparison
IUIAnimationManager2::SetConcludePriorityComparison