Compartir a través de


Método IUIAnimationTimer::SetTimerUpdateHandler (uianimation.h)

Especifica un controlador de actualización del temporizador.

Sintaxis

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

Parámetros

[in, optional] updateHandler

Un controlador de actualización del temporizador o NULL (vea Comentarios). El objeto especificado debe implementar la interfaz IUIAnimationTimerUpdateHandler .

[in] idleBehavior

Miembro de UI_ANIMATION_IDLE_BEHAVIOR que especifica el comportamiento del temporizador cuando está inactivo.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si el controlador de actualización ya está conectado a un temporizador, este método devuelve UI_E_TIMER_CLIENT_ALREADY_CONNECTED. De lo contrario, devuelve un código de error de HRESULT. Consulta Códigos de error de animación de Windows para obtener una lista de códigos de error.

Comentarios

El controlador de actualización del temporizador recibe actualizaciones de hora (tics) del temporizador. El temporizador indica una actualización llamando a IUIAnimationTimerUpdateHandler::OnUpdate
método en el controlador especificado.

Pasar NULL para el parámetro updateHandler hace que La animación de Windows libere su referencia a cualquier objeto de controlador que haya pasado anteriormente. Esta técnica puede ser esencial para interrumpir los ciclos de referencia sin tener que llamar al método IUIAnimationManager::Shutdown .

Ejemplos

Para obtener un ejemplo, vea Actualizar el Administrador de animaciones.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista y Actualización de plataforma para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado uianimation.h
Archivo DLL UIAnimation.dll

Consulte también

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler