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 Animation 釋放其先前傳入之任何處理程式物件的參考。 這項技術對於中斷參考週期而言可能很重要,而不需要呼叫 IUIAnimationManager::Shutdown 方法。

範例

如需範例,請參閱 更新動畫管理員

規格需求

   
最低支援的用戶端 適用于 Windows Vista 的 Windows 7、Windows Vista 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 uianimation.h
Dll UIAnimation.dll

另請參閱

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler