IUIAnimationTimer::SetTimerUpdateHandler-Methode (uianimation.h)
Gibt einen Timerupdatehandler an.
Syntax
HRESULT SetTimerUpdateHandler(
[in, optional] IUIAnimationTimerUpdateHandler *updateHandler,
[in] UI_ANIMATION_IDLE_BEHAVIOR idleBehavior
);
Parameter
[in, optional] updateHandler
Ein Timerupdatehandler oder NULL (siehe Hinweise). Das angegebene Objekt muss die IUIAnimationTimerUpdateHandler-Schnittstelle implementieren.
[in] idleBehavior
Ein Member von UI_ANIMATION_IDLE_BEHAVIOR , der das Verhalten des Timers im Leerlauf angibt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn der Updatehandler bereits mit einem Timer verbunden ist, gibt diese Methode UI_E_TIMER_CLIENT_ALREADY_CONNECTED zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Windows-Animationsfehlercodes .
Hinweise
Der Zeitgeberupdatehandler empfängt Zeitupdates (Ticks) vom Timer. Der Timer gibt ein Update an, indem IUIAnimationTimerUpdateHandler::OnUpdate aufgerufen wird.
-Methode für den angegebenen Handler.
Das Übergeben von NULL für den parameter updateHandler 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.
Beispiele
Ein Beispiel finden Sie unter Aktualisieren des Animations-Managers.
Anforderungen
| 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 |