Freigeben über


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

Weitere Informationen

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler