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

Artigo
07/16/2024

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

Sintaxe

Status AddClosedCurve(
  const PointF *points,
  INT          count
);

Parâmetros

points

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

count

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

Valor de retorno

Tipo de : de 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.

Observações

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 Bézier e armazena os pontos que definem esses splines 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, em seguida, desenha o caminho.

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

   PointF pts[] = {PointF(50.0f,50.0f),
                   PointF(60.0f,20.0f),
                   PointF(70.0f,100.0f),
                   PointF(80.0f,50.0f)};

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

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