IDCompositionVisual::SetOffsetY (float) 方法 (dcomp.h)

更改此视觉对象的 OffsetY 属性的值。 OffsetY 属性指定视觉对象相对于父视觉对象沿 y 轴的新偏移量。

语法

HRESULT SetOffsetY(
  [in] float offsetY
);

参数

[in] offsetY

类型: float

视觉对象沿 y 轴的新偏移量(以像素为单位)。

返回值

类型: HRESULT

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

备注

如果 offsetY 参数为 NaN、正无穷大或负无穷大,此方法将失败。

更改 OffsetY 属性将转换根植于此视觉对象的整个视觉对象子树的坐标系。 如果指定了此视觉对象的 Clip 属性,则也会转换剪辑矩形。

由 Transform 属性指定的转换在 OffsetY 属性之后应用。 换句话说,设置 Transform 属性和 OffsetY 属性的效果与仅在转换组对象上设置 Transform 属性相同,其中组的第一个成员是具有与 offsetY 相同的 OffsetY 值的 IDCompositionTranslateTransform 对象。 但是,应尽可能使用 IDCompositionVisual::SetOffsetY ,因为它稍微快一点。

如果 OffsetX 和 OffsetY 属性设置为 0,而 Transform 属性设置为 NULL,则视觉对象的坐标系与其父级的坐标系统相同。

如果以前对 OffsetY 属性进行了动画处理,则此方法将删除动画并将属性设置为指定的静态值。

示例

有关示例,请参阅 如何生成简单的可视化树

要求

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

另请参阅

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetTransform