IntersectClipRect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function creates a new clipping region from the intersection of the current clipping region and the specified rectangle.

Syntax

int IntersectClipRect(
  HDC hdc, 
  int nLeftRect, 
  int nTopRect, 
  int nRightRect, 
  int nBottomRect
); 

Parameters

• hdc
  [in] Handle to the device context.

• nLeftRect
  [in] Specifies the logical x-coordinate of the upper left corner of the rectangle.

• nTopRect
  [in] Specifies the logical y-coordinate of the upper left corner of the rectangle.

• nRightRect
  [in] Specifies the logical x-coordinate of the lower right corner of the rectangle.

• nBottomRect
  [in] Specifies the logical y-coordinate of the lower right corner of the rectangle.

Return Value

The return value specifies the new clipping region's type.

NULLREGION indicates that the region is empty.

SIMPLEREGION indicates that the region is a single rectangle.

COMPLEXREGION indicates that the region is more than a single rectangle.

ERROR indicates that an error occurred; the current clipping region is unaffected.

Remarks

The lower-most and right-most edges of the specified rectangle are excluded from the clipping region.

Requirements

See Also

Reference

ExcludeClipRect
GDI Functions