Método Graphics::D rawLines(constPen,constPoint,INT) (gdiplusgraphics.h)

Artigo
08/24/2023

O método Graphics::D rawLines desenha uma sequência de linhas conectadas.

Sintaxe

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

Parâmetros

[in] pen

Tipo: caneta* const

Ponteiro para uma caneta usada para desenhar as linhas.

[in] points

Tipo: const Point*

Ponteiro para uma matriz de objetos Point que especificam os pontos inicial e final das linhas.

[in] count

Tipo: INT

Inteiro que especifica o número de elementos na matriz de pontos .

Valor retornado

Tipo: Status

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

Cada linha requer um ponto de partida e um ponto final. O ponto final de cada linha é o ponto de partida para o próximo.

Exemplos

O exemplo a seguir desenha uma sequência de linhas conectadas.


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

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

   // Create an array of Point objects that define the lines to draw.
   Point point1(10, 10);
   Point point2(10, 100);
   Point point3(200, 50);
   Point point4(250, 300);

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

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

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll