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 메서드를 호출하지 않고도 참조 주기를 중단하는 데 필수적일 수 있습니다.

예제

예제는 애니메이션 관리자 업데이트를 참조하세요.

요구 사항

추가 정보

IUIAnimationTimer

IUIAnimationTimer::SetTimerEventHandler

IUIAnimationTimerUpdateHandler