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

Especifica um manipulador de atualização de temporizador.

Sintaxe

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

Parâmetros

[in, optional] updateHandler

Um manipulador de atualização de temporizador ou NULL (consulte Comentários). O objeto especificado deve implementar a interface IUIAnimationTimerUpdateHandler .

[in] idleBehavior

Um membro do UI_ANIMATION_IDLE_BEHAVIOR que especifica o comportamento do temporizador quando ele está ocioso.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se o manipulador de atualização já estiver conectado a um temporizador, esse método retornará UI_E_TIMER_CLIENT_ALREADY_CONNECTED. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.

Comentários

O manipulador de atualização de temporizador recebe atualizações de tempo (tiques) do temporizador. O temporizador indica uma atualização chamando IUIAnimationTimerUpdateHandler::OnUpdate
no manipulador especificado.

Passar NULL para o parâmetro updateHandler faz com que a Animação do Windows libere sua referência a qualquer objeto de manipulador passado anteriormente. Essa técnica pode ser essencial para quebrar ciclos de referência sem precisar chamar o método IUIAnimationManager::Shutdown .

Exemplos

Para obter um exemplo, consulte Atualizar o Gerenciador de Animação.

Requisitos

Confira também

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler