The ExcludeClipRect function creates a new clipping region that consists of the existing clipping region minus the specified rectangle.
int ExcludeClipRect(
| HDC hdc, | // handle to device context |
| int nLeftRect, | // x-coordinate of upper-left corner of rectangle |
| int nTopRect, | // y-coordinate of upper-left corner of rectangle |
| int nRightRect, | // x-coordinate of lower-right corner of rectangle |
| int nBottomRect | // y-coordinate of lower-right corner of rectangle |
| ); |
Parameters
hdc
Identifies the device context.
nLeftRect
Specifies the logical x-coordinate of the upper-left corner of the rectangle.
nTopRect
Specifies the logical y-coordinate of the upper-left corner of the rectangle.
nRightRect
Specifies the logical x-coordinate of the lower-right corner of the rectangle.
nBottomRect
Specifies the logical y-coordinate of the lower-right corner of the rectangle.
Return Values
If the function succeeds, the return value specifies the new clipping region's complexity and can be any one of the following values:
| Value | Meaning |
| NULLREGION | Region is empty. |
| SIMPLEREGION | Region is a single rectangle. |
| COMPLEXREGION | Region is more than one rectangle. |
| ERROR | No region was created. |
Remarks
The lower and right edges of the specified rectangle are not excluded from the clipping region.
See Also