ExcludeClipRect
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