IUIAnimationInterpolator2::SetDuration 方法 (uianimation.h)
在给定维度中设置转换的持续时间。
语法
HRESULT SetDuration(
[in, out] UI_ANIMATION_SECONDS duration
);
参数
[in, out] duration
切换的持续时间。
返回值
如果成功,则返回 S_OK ;否则为 HRESULT 错误代码。 有关错误代码列表,请参阅 Windows 动画 错误代码。
注解
Windows 动画仅在调用 IUIAnimationInterpolator2::GetDependencies 方法后调用此方法,并且仅当该调用返回 UI_ANIMATION_DEPENDENCY_DURATION 作为其 durationDependencies 标志之一时。
通常,具有持续时间依赖项的内插器在与该内插器关联的 IUIAnimationTransitionFactory 或 IUIAnimationTransitionFactory2 创建方法中具有持续时间参数。 内插器应在首次初始化时存储其持续时间,并在调用 SetDuration 时覆盖持续时间。
Windows 动画始终调用 IUIAnimationInterpolator2::SetInitialValueAndVelocity 方法以在调用 SetDuration 之前设置初始值和速度,因此自定义内插器无需检查是否已设置初始值和速度。
Windows 动画可以使用不同的参数多次调用 SetInitialValueAndVelocity 和 SetDuration 。 内插器可以缓存内部状态以提高性能,但它们必须在每次调用 SetInitialValueAndVelocity 时更新此缓存状态,并确保对 SetDuration 的后续调用结果反映更新后的状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8、Windows 7 和适用于 Windows 7 的平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | uianimation.h |
DLL | UIAnimation.dll |