Output(OS_POLYLINE)

WORD Output(
  LPPDEVICE lpDestDev, 
  WORD wStyle, 
  WORD wCount, 
  LPPOINT lpPoints, 
  LPPPEN lpPPen, 
  LPPBRUSH lpPBrush, 
  LPDRAWMODE lpDrawMode, 
  LPRECT lpClipRect
 );
 

Draws a set of line segments.

1 Function was successful.
0 Unrecoverable error occurred.
-1 Function does not support the specified style.

lpDestDev
Address of a PDEVICE or PBITMAP structure that specifies the destination device or bitmap.
wStyle
Must be OS_POLYLINE.
wCount
The number of POINT structures in the array pointed to by the lpPoints parameter. The wCount parameter must be at least two.
lpPoints
Address of an array of POINT structures that specifies the endpoints of the lines segments. The array has wCount elements.
lpPPen
Address of a PPEN structure that specifies the physical pen that is used to draw lines.
lpPBrush
Must be NULL.
lpDrawMode
Address of a DRAWMODE structure that contains information that is used when drawing, such as binary raster operation, background mode, and foreground and background color.
lpClipRect
Address of a RECT structure that contains coordinates for the clipping rectangle. If the lpClipRect parameter is NULL, the clipping rectangle is the entire display surface.

Although the line segment may create a closed figure, Output never fills the figure. GDI calls this function when an application calls functions such as the Polyline function (GDI.37).

Every graphics driver (for Windows version 2.0 and later) must support the OS_POLYLINE style.

Output draws each line segment from its starting point up to, but not including, its ending point. If more than one line segment is drawn, each new segment starts at the ending point of the previous segment.

Because Output does not use a physical brush to draw the lines, the lpPBrush parameter is usually NULL.

See Also

PDEVICE, PBITMAP, DRAWMODE, RECT, POINT