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

Artículo
07/16/2024

El método GraphicsPath::AddClosedCurve agrega una spline cardinal cerrada a esta ruta de acceso.

Sintaxis

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

Parámetros

points

Puntero a una matriz de puntos que definen la spline cardinal. La spline cardinal es una curva que pasa por cada punto de la matriz.

count

Entero que especifica el número de elementos de la matriz de puntos.

Valor devuelto

Tipo de : estado de

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status Status.

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Observaciones

Debe conservar una copia de la matriz de puntos si esos puntos serán necesarios más adelante. El objeto GraphicsPath de no almacena los puntos pasados al método GraphicsPath::AddClosedCurve; en su lugar, convierte la spline cardinal en una secuencia de splines bézier y almacena los puntos que definen esas splines bézier. No se puede recuperar la matriz original de puntos del objeto GraphicsPath.

Ejemplos

En el ejemplo siguiente se crea una ruta de acceso GraphicsPath objeto, se agrega una spline cardinal cerrada a la ruta de acceso y, a continuación, se dibuja la ruta de acceso.

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);
}