Polyline info  Overview  Group

The Polyline function draws a series of line segments by connecting the points in the specified array.

BOOL Polyline(

HDC hdc,	// handle of device context
CONST POINT *lppt,	// address of array containing endpoints
int cPoints	// number of points in the array
);

Parameters

hdc

Identifies a device context.

lppt

Points to an array of POINT structures. Each structure in the array identifies a point in logical space.

cPoints

Specifies the number of points in the array. This number must be greater than or equal to two.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The lines are drawn from the first point through subsequent points by using the current pen. Unlike the LineTo function, the Polyline function neither uses nor updates the current position.

See Also

LineTo, MoveToEx, POINT, PolylineTo, PolyPolyline