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

Spécifie un gestionnaire de mise à jour du minuteur.

Syntaxe

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

Paramètres

[in, optional] updateHandler

Un gestionnaire de mise à jour du minuteur, ou NULL (voir remarques). L’objet spécifié doit implémenter l’interface IUIAnimationTimerUpdateHandler .

[in] idleBehavior

Membre de UI_ANIMATION_IDLE_BEHAVIOR qui spécifie le comportement du minuteur lorsqu’il est inactif.

Valeur retournée

Si la méthode réussit, retourne S_OK. Si le gestionnaire de mise à jour est déjà connecté à un minuteur, cette méthode retourne UI_E_TIMER_CLIENT_ALREADY_CONNECTED. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur d’animation Windows .

Remarques

Le gestionnaire de mise à jour du minuteur reçoit des mises à jour de temps (cycles) du minuteur. Le minuteur indique une mise à jour en appelant IUIAnimationTimerUpdateHandler::OnUpdate
sur le gestionnaire spécifié.

Le passage de la valeur NULL pour le paramètre updateHandler entraîne la libération de la référence de l’animation Windows à n’importe quel objet gestionnaire que vous avez passé précédemment. Cette technique peut être essentielle pour rompre les cycles de référence sans avoir à appeler la méthode IUIAnimationManager::Shutdown .

Exemples

Pour obtenir un exemple, consultez Mettre à jour le Gestionnaire d’animations.

Configuration requise

Voir aussi

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler