IDCompositionAnimation::End 方法 (dcompanimation.h)

添加一个结束段,用于标记动画函数的结束。

语法

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

参数

[in] endOffset

类型: double

从动画函数的开头到函数结束时的点的偏移量(以秒为单位)。

[in] endValue

类型: float

动画的最终值。

返回值

类型: HRESULT

如果函数成功,则返回S_OK。 否则,将返回 HRESULT 错误代码。 有关错误代码列表,请参阅 DirectComposition 错误代码。

备注

当达到指定的偏移量时,受此动画影响的属性将设置为指定的最终值,然后动画停止。 如果未添加结束段,动画函数的最终段将无限期运行。 调用此方法在语义上与将动画函数的最后一段设置为三次多项式相同,其中立方、二次和线性系数均为零,常量系数是所需的最终值。

由于必须按增加顺序添加动画段,因此如果 endOffset 参数小于或等于上一段的 beginOffset 参数,此方法将失败。 如果这是要添加到动画函数的第一个段,则此方法也会失败。

调用此方法后,除 IDCompositionAnimation::Reset 方法外,此动画对象上的所有方法都会失败。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 dcompanimation.h
Library Dcomp.lib
DLL Dcomp.dll

请参阅

IDCompositionAnimation