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 |