subtractRect 函数 (winuser.h)

  • 项目

SubtractRect 函数通过从另一个矩形中减去一个矩形来确定矩形的坐标。

语法

BOOL SubtractRect(
  [out] LPRECT     lprcDst,
  [in]  const RECT *lprcSrc1,
  [in]  const RECT *lprcSrc2
);

参数

[out] lprcDst

指向 RECT 结构的指针，该结构接收矩形的坐标，方法是从 lprcSrc1 指向的矩形中减去 lprcSrc2 指向的矩形。

[in] lprcSrc1

指向 RECT 结构的指针，函数从中减去 lprcSrc2 指向的矩形。

[in] lprcSrc2

指向 RECT 结构的指针，该函数从 lprcSrc1 指向的矩形中减去该结构。

返回值

如果生成的矩形为空，则返回值为零。

如果生成的矩形不为空，则返回值为非零。

注解

当矩形在 x 方向或 y 方向完全相交时，函数仅从 lprcSrc1 指定的矩形中减去 lprcSrc2 指定的矩形。 例如，如果 *lprcSrc1 的坐标 (10，10，100，100) ，而 *lprcSrc2 的坐标 (50，50，150，150，150) ， 函数将 lprcDst 指向的矩形的坐标设置为 (10，10，100，100，100) 。 如果 *lprcSrc1 的坐标 (10，10，100，100) 且 *lprcSrc2 的坐标 (50，10，150，150，150) ， 但是，函数将 lprcDst 指向的矩形的坐标设置为 (10，10，50，100) 。 换句话说，生成的矩形是几何差的边界框。

由于应用程序可以将矩形用于不同的目的，因此矩形函数不使用显式度量单位。 相反，所有矩形坐标和维度都以带符号的逻辑值提供。 使用矩形的映射模式和函数确定度量单位。

要求

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

另请参阅

IntersectRect

矩形

矩形函数

矩形概述

UnionRect