CDC::PolyPolygon

Creates two or more polygons that are filled using the current polygon-filling mode.

BOOL PolyPolygon( 
   LPPOINT lpPoints, 
   LPINT lpPolyCounts, 
   int nCount  
);

Parameters

  • lpPoints
    Points to an array of POINT structures or CPoint objects that define the vertices of the polygons.

  • lpPolyCounts
    Points to an array of integers, each of which specifies the number of points in one of the polygons in the lpPoints array.

  • nCount
    The number of entries in the lpPolyCounts array. This number specifies the number of polygons to be drawn. This value must be at least 2.

Return Value

Nonzero if the function is successful; otherwise 0.

Remarks

The polygons may be disjoint or overlapping.

Each polygon specified in a call to the PolyPolygon function must be closed. Unlike polygons created by the Polygon member function, the polygons created by PolyPolygon are not closed automatically.

The function creates two or more polygons. To create a single polygon, an application should use the Polygon member function.

The current polygon-filling mode can be retrieved or set by using the GetPolyFillMode and SetPolyFillMode member functions.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::GetPolyFillMode

CDC::Polygon

CDC::Polyline

CDC::SetPolyFillMode

PolyPolygon

POINT Structure

CPoint Class