CDC::PolyPolygon

Syntax

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.

Remarks

Creates two or more polygons that are filled using the current polygon-filling mode. The polygons may be disjoint or they may overlap.

Each polygon specified in a call to the PolyPolygon function must be closed. Unlike polygons created by the Polygon member function of CDC, 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.

Return Value

TRUE if the function is successful; otherwise FALSE.

See Also

CDC::GetPolyFillMode, CDC::Polygon, CDC::Polyline, CDC::SetPolyFillMode, ::PolyPolygon