IDCompositionRectangleClip::SetTop (float) 方法 (dcomp.h)

更改剪辑矩形的 Top 属性的值。 Top 属性指定剪辑矩形左上角的 y 坐标。

语法

HRESULT SetTop(
  [in] float top
);

参数

[in] top

类型: float

Top 属性的新值(以像素为单位)。 此参数的数值限制为 -2^21 到 2^21。 API 接受此范围之外的数字,但它们始终被固定到此范围。

返回值

类型: HRESULT

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

注解

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

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

要求

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

另请参阅

IDCompositionRectangleClip