平台 SDK: Windows GDI

PtInRect

PtInRect函数确定指定的点是否位于指定的矩形内。 如果一个点位于左侧或顶侧或位于所有四条边内,则该点位于矩形内。 右侧或底侧的一个点被认为是在矩形外部。

BOOL PtInRect(
  CONST RECT *lprc,  // 矩形
  POINT pt           // 点
);

参数

  • lprc

  • [in] 指向包含指定矩形的RECT结构的指针。

  • pt

  • [in] 指定包含指定点的POINT结构。

返回值

如果指定的点位于矩形内,则返回值不为零。

如果指定的点不在矩形内,则返回值为零。

备注

在调用PtInRect之前,矩形必须标准化。 也就是说,lprc.right必须大于lprc.left,而lprc.bottom必须大于lprc.top。 如果矩形未标准化,则矩形内永远不会考虑点。

因为应用程序可以为不同目的使用矩形,所以矩形函数不使用明确的度量单位。 相反,所有的矩形坐标和尺寸都以有符号的逻辑值给出。 映射模式和使用矩形的函数决定了度量单位。

示例代码

有关示例,请参阅使用矩形。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.1和更高版本中。

  Windows 95/98/Me: 包含在Windows 95和更高版本中。

  头文件: 声明于 Winuser.h; 包含于 Windows.h.
  库: 使用 User32.lib.