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 動畫錯誤碼。

備註

此方法會指示分鏡腳本嘗試使用下列規則，將本身新增至播放分鏡腳本的排程：

如果沒有播放腳本以動畫顯示任何相同的動畫變數，則嘗試會成功，而分鏡腳本會立即開始播放。
如果分鏡腳本優先取消、修剪、結束或壓縮衝突的分鏡腳本，則嘗試排程成功，腳本會儘快開始播放。
如果分鏡腳本沒有優先順序，則嘗試會失敗，且 schedulingResult 參數會設定為 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