SubtractRect
The SubtractRect
function obtains the coordinates of a rectangle determined by subtracting one
rectangle from another.
BOOL SubtractRect(
|
LPRECT lprcDst, |
// pointer to
destination rectangle |
|
CONST RECT *lprcSrc1, |
// pointer to
rectangle to subtract from |
|
CONST RECT *lprcSrc2 |
// pointer to
rectangle to subtract |
|
); |
|
Parameters
lprcDst
Points to a RECT structure that receives the
coordinates of the rectangle determined by subtracting the rectangle pointed to
by lprcSrc2 from the rectangle pointed to by lprcSrc1.
lprcSrc1
Points to a RECT
structure from which the function subtracts the rectangle pointed to by lprcSrc2.
lprcSrc2
Points to a RECT
structure that the function subtracts from the rectangle pointed to by lprcSrc1.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero.
Remarks
The function
only subtracts the rectangle specified by lprcSrc2 from the rectangle
specified by lprcSrc1 when the rectangles intersect completely in either
the x- or y-direction. For example, if *lprcSrc1 has the coordinates (10,10,100,100)
and *lprcSrc2 has the coordinates (50,50,150,150), the function sets the
coordinates of the rectangle pointed to by lprcDst to (10,10,100,100).
If *lprcSrc1 has the coordinates (10,10,100,100) and *lprcSrc2
has the coordinates (50,10,150,150), however, the function sets the coordinates
of the rectangle pointed to by lprcDst to (10,10,50,100).
See Also