PolylineTo

The PolylineTo function draws one or more straight lines.

BOOL PolylineTo(
  HDC hdc,            // handle to device context
  CONST POINT *lppt,  // pointer to array of points
  DWORD cCount        // number of points in array
);
 

Parameters

hdc

Handle to the device context.

lppt

Pointer to an array of POINT structures that contains the vertices of the line.

cCount

Specifies the number of points in the 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

A line is drawn from the current position to the first point specified by the lppt parameter by using the current pen. For each additional line, the function draws from the ending point of the previous line to the next point specified by lppt.

PolylineTo moves the current position to the ending point of the last line.

If the line segments drawn by this function form a closed figure, the figure is not filled.

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, LineTo, MoveToEx, POINT, Polyline