CDC::ExcludeClipRect 

virtual int ExcludeClipRect( int x1, int y1, int x2, int y2 );

virtual int ExcludeClipRect( LPCRECT lpRect );

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.

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.

Remarks

Creates a new clipping region that consists of the existing clipping region minus the specified rectangle.

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.

CDC Overview |  Class Members |  Hierarchy Chart

See Also   CDC::ExcludeUpdateRgn, ::ExcludeClipRect