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

Artículo
08/24/2023

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

Sintaxis

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

Parámetros

[in] points

Tipo: const PointF*

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.

[in] count

Tipo: INT

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

[in] tension

Tipo: REAL

Número real no negativo que controla la longitud de la curva y cómo se dobla la curva. Un valor de 0 especifica que la spline es una secuencia de segmentos de línea recta. A medida que aumenta el valor, la curva se llena.

Valor devuelto

Tipo: Estado

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

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

Comentarios

Debe conservar una copia de la matriz de puntos si esos puntos serán necesarios más adelante. El objeto GraphicsPath 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 del objeto GraphicsPath, se agrega una spline cardinal cerrada a la ruta de acceso y, a continuación, se dibuja la ruta de acceso. La tensión se establece en 1,0.

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, 1.0f);

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

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll