IDCompositionVisual::SetTransformParent 方法 (dcomp.h)

设置此视觉对象的 TransformParent 属性。 TransformParent 属性建立相对于此视觉对象构成的坐标系。

语法

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

参数

[in, optional] visual

类型: IDCompositionVisual*

建立此视觉对象的基本坐标系的新视觉对象。 此参数可以为 NULL。

返回值

类型: HRESULT

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

注解

视觉对象的坐标系由 OffsetX、OffsetY 和 Transform 属性修改。 通常,这些属性定义视觉对象相对于其直接父级的坐标系。 此方法指定此视觉对象的坐标系所基于的视觉对象。 指定的视觉对象必须是当前视觉对象的上级。 如果不是上级,则坐标系基于此视觉对象的直接父级,就像 TransformParent 属性设置为 NULL 一样。 由于视觉对象可以重新父级,因此,如果指定的视觉对象通过重定父级操作成为目标视觉对象的上级,则此属性可以再次生效。

如果 视觉对象 参数为 NULL,则坐标系始终相对于视觉对象的直接父级进行转换。 如果未使用此方法,则这是默认行为。

如果 视觉对象 参数是无效的指针,或者它不是由此视觉对象所在的 IDCompositionDevice 接口创建的,则此方法失败。 接口不能是自定义实现;只有 Microsoft DirectComposition 创建的接口才能与此方法一起使用。

要求

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

另请参阅

IDCompositionVisual