createRectRgn 函数 (wingdi.h)

CreateRectRgn 函数创建矩形区域。

语法

HRGN CreateRectRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

参数

[in] x1

指定区域左上角的 x 坐标(以逻辑单元为单位)。

[in] y1

以逻辑单元为单位指定区域左上角的 y 坐标。

[in] x2

指定区域右下角的 x 坐标(以逻辑单元为单位)。

[in] y2

以逻辑单元为单位指定区域右下角的 y 坐标。

返回值

如果函数成功,则返回值是区域的句柄。

如果函数失败,则返回值为 NULL。

注解

如果不再需要 HRGN 对象,请调用 DeleteObject 函数将其删除。

区域坐标表示为 27 位带符号整数。

创建<形状>Rgn 方法创建的区域 (如 CreateRectRgnCreatePolygonRgn) 仅包括形状的内部;形状的轮廓从该区域中排除。 这意味着两个连续顶点之间的直线上的任何点都不包括在该区域中。 如果要为此类点调用 PtInRegion ,它将返回零作为结果。

示例

有关示例,请参阅 绘图标记。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

区域函数

区域概述

SelectObject