CDC::ExcludeClipRect
Creates a new clipping region that consists of the existing clipping region minus the specified rectangle.
int ExcludeClipRect(
int x1,
int y1,
int x2,
int y2
);
int ExcludeClipRect(
LPCRECT lpRect
);
Parameters
x1
Specifies the logical x-coordinate of the upper-left corner of the rectangle.y1
Specifies the logical y-coordinate of the upper-left corner of the rectangle.x2
Specifies the logical x-coordinate of the lower-right corner of the rectangle.y2
Specifies the logical y-coordinate of the lower-right corner of the rectangle.lpRect
Specifies the rectangle. Can also be a CRect object.
Return Value
Specifies the new clipping region's type. It can be any of the following values:
COMPLEXREGION The region has overlapping borders.
ERROR No region was created.
NULLREGION The region is empty.
SIMPLEREGION The region has no overlapping borders.
Remarks
The width of the rectangle, specified by the absolute value of x2 – x1, must not exceed 32,767 units. This limit applies to the height of the rectangle as well.
Requirements
Header: afxwin.h