Método GraphicsPath::AddClosedCurve(constPoint*,INT,REAL) (gdipluspath.h)

Artigo
02/26/2024

O método GraphicsPath::AddClosedCurve adiciona um spline cardinal fechado a esse caminho.

Sintaxe

Status AddClosedCurve(
  [in] const Point *points,
  [in] INT         count,
  [in] REAL        tension
);

Parâmetros

[in] points

Tipo: const Point*

Ponteiro para uma matriz de pontos que definem o spline cardinal. O spline cardinal é uma curva que passa por cada ponto na matriz.

[in] count

Tipo: INT

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

[in] tension

Tipo: REAL

Número real não negativo que controla o comprimento da curva e como a curva se dobra. Um valor de 0 especifica que o spline é uma sequência de linhas retas. À medida que o valor aumenta, a curva fica mais completa.

Retornar valor

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

Você deverá manter uma cópia da matriz de pontos se esses pontos forem necessários posteriormente. O objeto GraphicsPath não armazena os pontos passados para o método GraphicsPath::AddClosedCurve ; em vez disso, converte o spline cardinal em uma sequência de splines de Bézier e armazena os pontos que definem esses splines de Bézier. Não é possível recuperar a matriz original de pontos do objeto GraphicsPath .

Exemplos

O exemplo a seguir cria um caminho de objeto GraphicsPath, adiciona um spline cardinal fechado ao caminho e desenha o caminho. A tensão está definida para 1,0.

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

   Point pts[] = {Point(50,50),
                  Point(60,20),
                  Point(70,100),
                  Point(80,50)};

   GraphicsPath path;
   path.AddClosedCurve(pts, 4, 1.0f);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Requisitos

Requisito	Valor
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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll