IUIAnimationStoryboard2：：Schedule 方法 (uianimation.h)

项目
08/26/2023

指示情节提要自行安排播放。

语法

HRESULT Schedule(
  [in]            UI_ANIMATION_SECONDS           timeNow,
  [out, optional] UI_ANIMATION_SCHEDULING_RESULT *schedulingResult
);

参数

[in] timeNow

当前时间。

[out, optional] schedulingResult

计划请求的结果。可以在对此方法的调用中省略此参数。

返回值

如果成功，则返回S_OK;否则为 HRESULT 错误代码。有关错误代码列表，请参阅 Windows 动画错误代码。

注解

此方法指示情节提要尝试将自身添加到播放情节提要的计划，使用以下规则：

如果没有播放情节提要对任何相同的动画变量进行动画处理，则尝试将成功，情节提要立即开始播放。
如果情节提要优先取消、剪裁、结束或压缩冲突的情节提要，则计划尝试成功，情节提要将尽快开始播放。
如果情节提要没有优先级，则尝试失败， scheduleResult 参数设置为 UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY。

如果从 OnStoryboardStatusChanged 事件的处理程序调用此方法，则 schedulingResult 参数将设置为 UI_ANIMATION_SCHEDULING_DEFERRED。确定情节提要是否成功计划的唯一方法是设置情节提要事件处理程序，并检查情节提要的状态是否UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY。

在情节提要状态达到UI_ANIMATION_STORYBOARD_READY后，可以通过再次调用 Schedule 来重用情节提要。当情节提要处于除 UI_ANIMATION_STORYBOARD_BUILDING 或 UI_ANIMATION_STORYBOARD_READY 以外的任何状态时，尝试计划情节提要失败，并且 scheduleResult 设置为 UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED。

要求


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