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 标志之一时。

通常,具有持续时间依赖项的内插器在与该内插器关联的 IUIAnimationTransitionFactoryIUIAnimationTransitionFactory2 创建方法中具有持续时间参数。 内插器应在首次初始化时存储其持续时间,并在调用 SetDuration 时覆盖持续时间。

Windows 动画始终调用 IUIAnimationInterpolator2::SetInitialValueAndVelocity 方法以在调用 SetDuration 之前设置初始值和速度,因此自定义内插器无需检查是否已设置初始值和速度。

Windows 动画可以使用不同的参数多次调用 SetInitialValueAndVelocitySetDuration 。 内插器可以缓存内部状态以提高性能,但它们必须在每次调用 SetInitialValueAndVelocity 时更新此缓存状态,并确保对 SetDuration 的后续调用结果反映更新后的状态。

要求

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

另请参阅

IUIAnimationInterpolator2

UI_ANIMATION_DEPENDENCIES

UI_ANIMATION_SECONDS