IUIAnimationStoryboard2::SetStoryboardEventHandler メソッド (uianimation.h)

ストーリーボード イベントのハンドラーを指定します。

構文

HRESULT SetStoryboardEventHandler(
  [in, optional] IUIAnimationStoryboardEventHandler2 *handler,
  [in]           BOOL                                fRegisterStatusChangeForNextAnimationEvent,
  [in]           BOOL                                fRegisterUpdateForNextAnimationEvent
);

パラメーター

[in, optional] handler

ストーリーボードの状態と更新イベントが発生するたびに Windows アニメーションが呼び出すハンドラー。

指定したオブジェクトは 、IUIAnimationStoryboardEventHandler2 インターフェイスを実装するか 、NULL にする必要があります。 詳細については、「解説」を参照してください。

[in] fRegisterStatusChangeForNextAnimationEvent

TRUE の場合、OnStoryboardStatusChanged イベントを登録し、IUIAnimationManager2::EstimateNextEventTime にこれらのイベントを含めます。これにより、次のアニメーション イベントまでの時間間隔が推定されます。 既定値はありません。

[in] fRegisterUpdateForNextAnimationEvent

TRUE の場合、OnStoryboardUpdated イベントを登録し、IUIAnimationManager2::EstimateNextEventTime にこれらのイベントを含めます。これにより、次のアニメーション イベントまでの時間間隔が推定されます。 既定値はありません。

戻り値

成功した場合 は、S_OK を返します。それ以外の場合は HRESULT エラー コード。 エラー コードの一覧については、「 Windows アニメーション エラー コード 」を参照してください。

注釈

ハンドラー パラメーターに NULL を渡すと、Windows アニメーションは、前に渡したハンドラー オブジェクトへの参照を解放します。 この手法は、 IUIAnimationManager2::Shutdown メソッドを呼び出すことなく、参照サイクルを中断するために不可欠な場合があります。

要件

こちらもご覧ください

IUIAnimationStoryboard2

IUIAnimationStoryboardEventHandler2