subtractRect 函式 (winuser.h)

SubtractRect函式會決定矩形的座標，方法是從另一個矩形減去一個矩形。

語法

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

參數

[out] lprcDst

RECT結構的指標，接收矩形的座標，該矩形是由lprcSrc2所指向的矩形減去lprcSrc1所指向的矩形。

[in] lprcSrc1

RECT結構的指標，函式會從中減去lprcSrc2所指向的矩形。

[in] lprcSrc2

函式從lprcSrc1所指向之矩形減去的RECT結構的指標。

傳回值

如果產生的矩形是空的，則傳回值為零。

如果產生的矩形不是空的，則傳回值為非零。

備註

函式只會從 lprcSrc2 所指定的矩形減去 lprcSrc1 所指定的矩形，當矩形完全與 x 或 y 方向交集時。 例如，如果 *lprcSrc1 的座標 (10，100，100，100) ，而 *lprcSrc2 的座標 (50，50，150，150) ， 函式會將 lprcDst 指向的矩形座標設定為 (10，10，100，100) 。 如果 *lprcSrc1 的座標 (10，100，100，100) ，而 *lprcSrc2 的座標 (50，10，150，150) ， 不過，函式會將 lprcDst 指向的矩形座標設定為 (10，10，50，100) 。 換句話說，產生的矩形是幾何差異的周框方塊。

因為應用程式可以針對不同的用途使用矩形，所以矩形函式不會使用明確的量值單位。 相反地，所有矩形座標和維度都會以帶正負號的邏輯值來指定。 使用矩形的對應模式和函式會決定量值單位。

規格需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll

另請參閱

IntersectRect

矩形

矩形函式

矩形概觀

UnionRect