IntersectClipRect

  • Article

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

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 Values

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- and right-most edges of the specified rectangle are excluded from the clipping region.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

ExcludeClipRect | GDI Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.