Graphics::DrawLine(constPen*,constPoint&,constPoint&) method (gdiplusgraphics.h)

The Graphics::DrawLine method draws a line that connects two points.

Syntax

Status DrawLine(
  [in]      const Pen     *pen,
  [in, ref] const Point & pt1,
  [in, ref] const Point & pt2
);

Parameters

[in] pen

Type: const Pen*

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

[in, ref] pt1

Type: const Point

Reference to a Point object that specifies the start of the line.

[in, ref] pt2

Type: const Point

Reference to a Point object that specifies the end of the line.

Return value

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.

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusgraphics.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also

DrawLines Methods

Graphics

Pens, Lines, and Rectangles

Point

Using a Pen to Draw Lines and Rectangles