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 |