IUIAnimationStoryboard2::SetStoryboardEventHandler-Methode (uianimation.h)
Gibt einen Handler für Storyboardereignisse an.
Syntax
HRESULT SetStoryboardEventHandler(
[in, optional] IUIAnimationStoryboardEventHandler2 *handler,
[in] BOOL fRegisterStatusChangeForNextAnimationEvent,
[in] BOOL fRegisterUpdateForNextAnimationEvent
);
Parameter
[in, optional] handler
Der Handler, den Die Windows-Animation aufrufen sollte, wenn Storyboard-status- und Updateereignisse auftreten.
Das angegebene Objekt muss die IUIAnimationStoryboardEventHandler2-Schnittstelle implementieren oder NULL sein. Weitere Informationen finden Sie unter Hinweise.
[in] fRegisterStatusChangeForNextAnimationEvent
Wenn TRUE, registriert das OnStoryboardStatusChanged-Ereignis und schließt diese Ereignisse in IUIAnimationManager2::EstimateNextEventTime ein, wodurch das Zeitintervall bis zum nächsten Animationsereignis geschätzt wird. Für dieses Feld gibt es keinen Standardwert.
[in] fRegisterUpdateForNextAnimationEvent
Wenn TRUE, registriert das OnStoryboardUpdated-Ereignis und schließt diese Ereignisse in IUIAnimationManager2::EstimateNextEventTime ein, wodurch das Zeitintervall bis zum nächsten Animationsereignis geschätzt wird. Für dieses Feld gibt es keinen Standardwert.
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
Das Übergeben von NULL für den Handlerparameter 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 Platform Update für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | uianimation.h |
| DLL | UIAnimation.dll |