IUIAnimationInterpolator2::SetDuration 方法 (uianimation.h)
設定指定維度中轉換的持續時間。
語法
HRESULT SetDuration(
[in, out] UI_ANIMATION_SECONDS duration
);
參數
[in, out] duration
轉換的持續時間。
傳回值
如果成功 , 則傳回S_OK;否則 為 HRESULT 錯誤碼。 如需錯誤碼的清單,請參閱 Windows 動畫錯誤碼 。
備註
只有在呼叫 IUIAnimationInterpolator2::GetDependencies 方法之後,Windows 動畫才會呼叫這個方法,而且只有在該呼叫傳回 UI_ANIMATION_DEPENDENCY_DURATION 為其 durationDependencies 旗標之一時。
一般而言,具有持續時間相依性之插補器在 IUIAnimationTransitionFactory 或 IUIAnimationTransitionFactory2 建立方法中具有與該插補器相關聯的持續時間參數。 插入器應該在第一次初始化時儲存其持續時間,並在呼叫 SetDuration 時覆寫持續時間。
Windows 動畫一律會呼叫 IUIAnimationInterpolator2::SetInitialValueAndVelocity 方法來設定初始值和速度,再呼叫 SetDuration,因此自定義插補器不需要檢查初始值和速度是否已設定。
Windows 動畫可以使用不同的參數多次呼叫 SetInitialValueAndVelocity 和 SetDuration 。 插補器可以快取內部狀態來改善效能,但必須在每次呼叫 SetInitialValueAndVelocity 時更新此快取狀態,並確保 後續呼叫 SetDuration 的結果會反映更新的狀態。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 的 Windows 8、Windows 7 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | uianimation.h |
Dll | UIAnimation.dll |