Share via


CAnimationTimerEventHandler Class

 

The latest version of this topic can be found at CAnimationTimerEventHandler Class.

Implements a callback, which is called by the Animation API when timing events occur.

Syntax

class CAnimationTimerEventHandler : public CUIAnimationTimerEventHandlerBase<CAnimationTimerEventHandler>;  

Members

Public Methods

Name Description
CAnimationTimerEventHandler::CreateInstance Creates an instance of CAnimationTimerEventHandler callback.
CAnimationTimerEventHandler::OnPostUpdate Handles events that occur after an animation update is finished. (Overrides CUIAnimationTimerEventHandlerBase::OnPostUpdate.)
CAnimationTimerEventHandler::OnPreUpdate Handles events that occur before an animation update begins. (Overrides CUIAnimationTimerEventHandlerBase::OnPreUpdate.)
CAnimationTimerEventHandler::OnRenderingTooSlow Handles events that occur when the rendering frame rate for an animation falls below the minimum desirable frame rate. (Overrides CUIAnimationTimerEventHandlerBase::OnRenderingTooSlow.)
CAnimationTimerEventHandler::SetAnimationController Stores a pointer to animation controller to route events.

Remarks

This event handler is created and passed to IUIAnimationTimer::SetTimerEventHandler when you call CAnimationController::EnableAnimationTimerEventHandler.

Inheritance Hierarchy

CUIAnimationCallbackBase

CUIAnimationTimerEventHandlerBase

CAnimationTimerEventHandler

Requirements

Header: afxanimationcontroller.h

CAnimationTimerEventHandler::CreateInstance

Creates an instance of CAnimationTimerEventHandler callback.

static COM_DECLSPEC_NOTHROW HRESULT CreateInstance(
    CAnimationController* pAnimationController,  
    IUIAnimationTimerEventHandler** ppTimerEventHandler);

Parameters

pAnimationController
A pointer to animation controller, which will receive events.

ppTimerEventHandler

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

CAnimationTimerEventHandler::OnPostUpdate

Handles events that occur after an animation update is finished.

IFACEMETHOD(OnPostUpdate)();

Return Value

S_OK if the method succeeds; otherwise E_FAIL.

CAnimationTimerEventHandler::OnPreUpdate

Handles events that occur before an animation update begins.

IFACEMETHOD(OnPreUpdate)();

Return Value

S_OK if the method succeeds; otherwise E_FAIL.

CAnimationTimerEventHandler::OnRenderingTooSlow

Handles events that occur when the rendering frame rate for an animation falls below the minimum desirable frame rate.

IFACEMETHOD(OnRenderingTooSlow)(UINT32 fps);

Parameters

fps

Return Value

S_OK if the method succeeds; otherwise E_FAIL.

CAnimationTimerEventHandler::SetAnimationController

Stores a pointer to animation controller to route events.

void SetAnimationController(CAnimationController* pAnimationController);

Parameters

pAnimationController
A pointer to animation controller, which will receive events.

See Also

Classes