IDCompositionVisual：：SetOffsetX (float) 方法 (dcomp.h)

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

语法

HRESULT SetOffsetX(
  [in] float offsetX
);

参数

[in] offsetX

类型： float

视觉对象沿 x 轴的新偏移量（以像素为单位）。

返回值

类型： HRESULT

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

备注

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

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

由 Transform 属性指定的转换在 OffsetX 属性之后应用。 换句话说，设置 Transform 属性和 OffsetX 属性的效果与仅在转换组对象上设置 Transform 属性相同，其中组的第一个成员是具有与 offsetX 相同的 OffsetX 值的 IDCompositionTranslateTransform 对象。 但是，应尽可能使用 IDCompositionVisual：：SetOffsetX ，因为它略快一些。

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

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

示例

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

要求

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

另请参阅

IDCompositionVisual

IDCompositionVisual：：SetOffsetY

IDCompositionVisual：：SetTransform