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 |