int ExcludeClipRect(hDC,X1,Y1,X2,Y2)
This function creates a new clipping region that consists of the existing clipping region minus the specified rectangle.
Parameter | Type/Description |
hDC | HDC Identifies the device context. | |
X1 | int Specifies the logical x-coordinate of the upper-left corner of the rectangle. | |
Y1 | int Specifies the logical y-coordinate of the upper-left corner of the rectangle. | |
X2 | int Specifies the logical x-coordinate of the lower-right corner of the rectangle. | |
Y2 | int Specifies the logical y-coordinate of the lower-right corner of the rectangle. |
The return value specifies the new clipping region's type. It can be any one of the
following values:
Value | Meaning |
COMPLEXREGION | The region has overlapping borders. | |
ERROR | No region was created. | |
NULLREGION | The region is empty. | |
SIMPLEREGION | The region has no overlapping borders. |
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.