CreateRectRgn

小甲鱼

函数文档：

CreateRectRgn 函数用于创建一个矩形区域。


API 函数原型：

HRGN CreateRectRgn(
  _In_ int nLeftRect,
  _In_ int nTopRect,
  _In_ int nRightRect,
  _In_ int nBottomRect
);

参数解析：

参数	含义
nLeftRect	指定矩形区域左上角的 x 坐标，逻辑单位
nTopRect	指定矩形区域左上角的 y 坐标，逻辑单位
nRightRect	指定矩形区域右下角的 x 坐标，逻辑单位
nBottomRect	指定矩形区域右下角的 x 坐标，逻辑单位

返回值：

1. 如果函数调用成功，返回值是矩形区域的句柄（类型是 HRGN）；

2. 如果函数调用失败，返回值是 NULL。


备注：

1. 当你不再需要这个 HRGN 对象，请使用 DeleteObject 函数删除它。

2. 矩形区域坐标用 27 位有符号整数表示。

3. 区域是对显示器上一个范围的描述，这个范围是矩形、多边形和椭圆的组合。区域一般用来绘制和剪裁，通过将区域选进设备上下文，就可以用区域来进行剪裁（就是说，将可以绘图的范围限制为显示区域的一部分）。

4. 创建区域的函数命名规则是 Create<图案>Rgn（例如创建矩形和多边形区域的函数叫做：CreateRectRng 和 CreatePolygonRgn）。创建的形状只包含内部面积，外部边框线不包含在建材区域内。这就意味着如果你调用 PtInRegion 函数判断两顺序顶点之间的任意一点的位置，均返回 0（不在区域内）。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。