Compartilhar via


Método Graphics::D rawLine(constPen*,REAL,REAL,REAL,REAL,REAL) (gdiplusgraphics.h)

O método Graphics::D rawLine desenha uma linha que conecta dois pontos.

Sintaxe

Status DrawLine(
  const Pen *pen,
  REAL      x1,
  REAL      y1,
  REAL      x2,
  REAL      y2
);

Parâmetros

pen

Ponteiro para uma caneta usada para desenhar a linha.

x1

Número real que especifica a coordenada x do ponto inicial da linha.

y1

Número real que especifica a coordenada y do ponto inicial da linha.

x2

Número real que especifica a coordenada x do ponto final da linha.

y2

Número real que especifica a coordenada y do ponto final da linha.

Valor retornado

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Exemplos

O exemplo a seguir desenha uma linha.

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

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

   // Initialize the coordinates of the points that define the line.
   REAL x1 = 100.0f;
   REAL y1 = 100.0f;
   REAL x2 = 500.0f;
   REAL y2 = 100.0f;

   // Draw the line.
   graphics.DrawLine(&blackPen, x1, y1, x2, y2);
}

Requisitos

   
Cabeçalho gdiplusgraphics.h

Confira também

Métodos DrawLines

Elementos gráficos

Canetas, linhas e retângulos

Pointf

Uso de uma caneta para desenhar linhas e retângulos