Metodo IUIAnimationTimer::SetTimerUpdateHandler (uianimation.h)

Specifica un gestore di aggiornamento timer.

Sintassi

HRESULT SetTimerUpdateHandler(
  [in, optional] IUIAnimationTimerUpdateHandler *updateHandler,
  [in]           UI_ANIMATION_IDLE_BEHAVIOR     idleBehavior
);

Parametri

[in, optional] updateHandler

Un gestore di aggiornamenti timer o NULL (vedere Osservazioni). L'oggetto specificato deve implementare l'interfaccia IUIAnimationTimerUpdateHandler .

[in] idleBehavior

Membro di UI_ANIMATION_IDLE_BEHAVIOR che specifica il comportamento del timer quando è inattiva.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se il gestore di aggiornamento è già connesso a un timer, questo metodo restituisce UI_E_TIMER_CLIENT_ALREADY_CONNECTED. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore dell'animazione di Windows .

Commenti

Il gestore degli aggiornamenti timer riceve gli aggiornamenti temporali (tick) dal timer. Il timer indica un aggiornamento chiamando IUIAnimationTimerUpdateHandler::OnUpdate
metodo nel gestore specificato.

Passando NULL per il parametro updateHandler , l'animazione di Windows rilascia il riferimento a qualsiasi oggetto gestore passato in precedenza. Questa tecnica può essere essenziale per i cicli di riferimento di interruzione senza dover chiamare il metodo IUIAnimationManager::Shutdown .

Esempio

Per un esempio, vedere Aggiornare Animation Manager.

Requisiti

Vedi anche

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler