IDCompositionTranslateTransform3D：：SetOffsetZ (IDCompositionAnimation*) 方法 (dcomp.h)

对 3D 平移转换效果的 OffsetZ 属性的值进行动画处理。 OffsetZ 属性指定要沿 z 轴平移的距离。

语法

HRESULT SetOffsetZ(
  [in] IDCompositionAnimation *animation
);

[in] animation

一个动画对象，确定 OffsetZ 属性的值如何随时间变化。此参数不能为 NULL。

类型： HRESULT

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

此方法创建指定动画的副本。如果在调用此方法后更改 了动画 参数引用的对象，则除非再次调用此方法，否则更改不会影响 OffsetZ 属性。如果以前对 OffsetZ 属性进行了动画处理，则调用此方法会将以前的动画替换为新的动画。

如果动画是无效指针，或者不是由创建受影响视觉对象的同一 IDCompositionDevice 接口创建的，则此方法失败。接口不能是自定义实现;只有 Microsoft DirectComposition 创建的接口才能与此方法一起使用。