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 动画 错误代码。

注解

handler 参数传递 NULL 会导致 Windows 动画释放其对前面传入的任何处理程序对象的引用。 此方法对于中断引用周期至关重要,无需调用 IUIAnimationManager2::Shutdown 方法。

要求

要求
最低受支持的客户端 Windows 8、Windows 7 和适用于 Windows 7 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 uianimation.h
DLL UIAnimation.dll

另请参阅

IUIAnimationStoryboard2

IUIAnimationStoryboardEventHandler2