CAnimationStoryboardEventHandler 類別

文章
10/12/2023

實作回呼，當腳本的狀態變更或更新腳本時由動畫 API 呼叫。

語法

class CAnimationStoryboardEventHandler : public CUIAnimationStoryboardEventHandlerBase<CAnimationStoryboardEventHandler>;

成員

公用建構函式

名稱	描述
CAnimationStoryboardEventHandler：：CAnimationStoryboardEventHandler	建構 `CAnimationStoryboardEventHandler` 物件。

公用方法

名稱	描述
CAnimationStoryboardEventHandler：：CreateInstance	建立回呼的 `CAnimationStoryboardEventHandler` 實例。
CAnimationStoryboardEventHandler：：OnStoryboardStatusChanged	處理 `OnStoryboardStatusChanged` 當分鏡腳本的狀態變更時所發生的事件（覆寫 `CUIAnimationStoryboardEventHandlerBase::OnStoryboardStatusChanged` 。）
CAnimationStoryboardEventHandler：：OnStoryboardUpdated	處理 `OnStoryboardUpdated` 事件，此事件會在腳本更新時發生（覆寫 `CUIAnimationStoryboardEventHandlerBase::OnStoryboardUpdated` 。）
CAnimationStoryboardEventHandler：：SetAnimationController	儲存動畫控制器的指標以路由事件。

備註

當您呼叫 CAnimationController::EnableStoryboardEventHandler 時，這個事件處理常式會建立並傳遞至 IUIAnimationStoryboard::SetStoryboardEventHandler 方法。

繼承階層架構

CUIAnimationCallbackBase

CUIAnimationStoryboardEventHandlerBase

CAnimationStoryboardEventHandler

需求

標頭： afxanimationcontroller.h

CAnimationStoryboardEventHandler：：CAnimationStoryboardEventHandler

建構 CAnimationStoryboardEventHandler 物件。

CAnimationStoryboardEventHandler();

CAnimationStoryboardEventHandler：：CreateInstance

建立 CAnimationStoryboardEventHandler 回呼的實例。

static COM_DECLSPEC_NOTHROW HRESULT CreateInstance(
    CAnimationController* pAnimationController,
    IUIAnimationStoryboardEventHandler** ppHandler);

參數

pAnimationController
動畫控制器的指標，將會接收事件。

ppHandler

傳回值

如果方法成功，則會傳回S_OK。否則，它會傳回 HRESULT 錯誤碼。

CAnimationStoryboardEventHandler：：OnStoryboardStatusChanged

處理 OnStoryboardStatusChanged 事件，此事件會在分鏡腳本的狀態變更時發生

IFACEMETHOD(OnStoryboardStatusChanged) (
    __in IUIAnimationStoryboard* storyboard,
    __in UI_ANIMATION_STORYBOARD_STATUS newStatus,
    __in UI_ANIMATION_STORYBOARD_STATUS previousStatus);

參數

腳本
腳本的指標，其狀態已變更。

newStatus
指定新的分鏡腳本狀態。

previousStatus
指定先前的分鏡腳本狀態。

傳回值

如果方法成功，S_OK;否則為 E_FAIL。

CAnimationStoryboardEventHandler：：OnStoryboardUpdated

處理 OnStoryboardUpdated 事件，此事件會在腳本更新時發生

IFACEMETHOD(OnStoryboardUpdated) (__in IUIAnimationStoryboard* storyboard);

參數

腳本
腳本的指標，已更新。

傳回值

如果方法成功，S_OK;否則為 E_FAIL。

CAnimationStoryboardEventHandler：：SetAnimationController

儲存動畫控制器的指標以路由事件。

void SetAnimationController(CAnimationController* pAnimationController);

參數