createPolygonRgn 函数 (wingdi.h)

CreatePolygonRgn 函数创建多边形区域。

语法

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

[in] pptl

指向 POINT 结构的数组的指针，这些结构以逻辑单元定义多边形的顶点。假定多边形已闭合。每个顶点只能指定一次。

[in] cPoint

数组中的点数。

[in] iMode

用于确定区域中哪些像素的填充模式。此参数的取值可为下列值之一：

值	含义
互生	选择备用模式 (填充每个扫描线) 上奇数和偶数多边形面之间的区域。
绕组	选择绕组模式 (使用非零绕组值) 填充任何区域。

有关这些模式的详细信息，请参阅 SetPolyFillMode 函数。

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

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

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

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

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


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