PolyPolyline

The PolyPolyline function draws multiple series of connected line segments.

BOOL PolyPolyline(
  HDC hdc,                      // handle to a device context
  CONST POINT *lppt,            // pointer to an array of points
  CONST DWORD *lpdwPolyPoints,  // pointer to an array of values
  DWORD cCount                  // count of entries in the second array
);
 

Parameters

hdc

Handle to the device context.

lppt

Pointer to an array of POINT structures that contains the vertices of the polylines. The polylines are specified consecutively.

lpdwPolyPoints

Pointer to an array of variables specifying the number of points in the lppt array for the corresponding polyline. Each entry must be greater than or equal to two.

cCount

Specifies the total number of entries in the lpdwPolyPoints array.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Windows NT: To get extended error information, call GetLastError.

Remarks

The line segments are drawn by using the current pen. The figures formed by the segments are not filled.

The current position is neither used nor updated by this function.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Lines and Curves Overview, Line and Curve Functions, POINT, Polyline, PolylineTo