IUIAnimationTimer::SetTimerUpdateHandler 方法 (uianimation.h)

指定计时器更新处理程序。

语法

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

参数

[in, optional] updateHandler

计时器更新处理程序,或 NULL (请参阅备注) 。 指定的对象必须实现 IUIAnimationTimerUpdateHandler 接口。

[in] idleBehavior

UI_ANIMATION_IDLE_BEHAVIOR 的成员,指定计时器空闲时的行为。

返回值

如果该方法成功,则它会返回 S_OK。 如果更新处理程序已连接到计时器,则此方法返回 UI_E_TIMER_CLIENT_ALREADY_CONNECTED。 否则,将返回 HRESULT 错误代码。 有关错误代码的列表,请参阅 Windows 动画 错误代码。

注解

计时器更新处理程序接收时间更新, (计时器) 计时周期。 计时器通过调用 IUIAnimationTimerUpdateHandler::OnUpdate 指示更新
指定处理程序上的 方法。

updateHandler 参数传递 NULL 会导致 Windows 动画释放其对之前传入的任何处理程序对象的引用。 此方法对于中断引用周期至关重要,无需调用 IUIAnimationManager::Shutdown 方法。

示例

有关示例,请参阅 更新动画管理器

要求

   
最低受支持的客户端 Windows 7、Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 uianimation.h
DLL UIAnimation.dll

另请参阅

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler