BOOL PolyDraw( const POINT* lpPoints, const BYTE* lpTypes, int nCount );
Return Value
Nonzero if the function is successful; otherwise 0.
Parameters
lpPoints
Points to an array of POINT data structures that contains the endpoints for each line segment and the endpoints and control points for each Bézier spline.
lpTypes
Points to an array that specifies how each point in the lpPoints array is used. Values can be one of the following:
PT_BEZIERTO types always occur in sets of three. The current position defines the starting point for the Bézier spline. The first two PT_BEZIERTO points are the control points, and the third PT_BEZIERTO point is the ending point. The ending point becomes the new current position. If there are not three consecutive PT_BEZIERTO points, an error results.
A PT_LINETO or PT_BEZIERTO type can be combined with the following constant by using the bitwise operator OR to indicate that the corresponding point is the last point in a figure and the figure is closed:
This flag is combined with the PT_LINETO type for a line, or with the PT_BEZIERTO type of ending point for a Bézier spline, by using the bitwise OR operator. The current position is set to the ending point of the closing line.
nCount
Specifies the total number of points in the lpPoints array, the same as the number of bytes in the lpTypes array.
Remarks
Draws a set of line segments and Bézier splines. This function can be used to draw disjoint figures in place of consecutive calls to CDC::MoveTo, CDC::LineTo, and CDC::PolyBezierTo member functions. The lines and splines are drawn using the current pen, and figures are not filled. If there is an active path started by calling the CDC::BeginPath member function, PolyDraw adds to the path. The points contained in the lpPoints array and in lpTypes indicate whether each point is part of a CDC::MoveTo, a CDC::LineTo, or a CDC::BezierTo operation. It is also possible to close figures. This function updates the current position.
CDC Overview | Class Members | Hierarchy Chart
See Also CDC::BeginPath, CDC::EndPath, CDC::LineTo, CDC::MoveTo, CDC::PolyBezierTo, CDC::PolyLine, ::PolyDraw