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

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

Syntax

Status DrawLine(
  [in] const Pen *pen,
  [in] INT       x1,
  [in] INT       y1,
  [in] INT       x2,
  [in] INT       y2
);

Parameters

[in] pen

Type: const Pen*

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

[in] x1

Type: INT

Integer that specifies the x-coordinate of the starting point of the line.

[in] y1

Type: INT

Integer that specifies the y-coordinate of the starting point of the line.

[in] x2

Type: INT

Integer that specifies the x-coordinate of the ending point of the line.

[in] y2

Type: INT

Integer that specifies the y-coordinate of the ending point 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