Graphics.DrawLines(const Pen*, const PointF*, INT) method

Applies to: desktop apps only

The Graphics::DrawLines method draws a sequence of connected lines.

Syntax

Status DrawLines(
  [in]  const Pen *pen,
  [in]  const PointF *points,
  [in]  INT count
);

Parameters

• pen [in]
  Type: const Pen*

  Pointer to a pen that is used to draw the lines.

• points [in]
  Type: const PointF*

  Pointer to an array of PointF objects that specify the starting and ending points of the lines.

• count [in]
  Type: INT

  Integer that specifies the number of elements in the points array.

Return value

Type:

Type: Status****

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Examples

The following example draws a sequence of connected lines.

VOID Example_DrawLines2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);

   // Create an array of PointF objects that define the lines to draw.
   PointF point1(10.0f, 10.0f);
   PointF point2(10.0f, 100.0f);
   PointF point3(200.0f, 50.0f);
   PointF point4(250.0f, 300.0f);

   PointF points[4] = {point1, point2, point3, point4};
   PointF* pPoints = points;

   // Draw the lines.
   graphics.DrawLines(&blackPen, pPoints, 4);
}

Requirements

Minimum supported client	Windows XP, Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	GDI+ 1.0
Header	Gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll

See also

Graphics

DrawLine Methods

Point

Using a Pen to Draw Lines and Rectangles

Pens, Lines, and Rectangles

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012