Metodo GraphicsPath::AddCurve(constPointF*,INT) (gdipluspath.h)

Articolo
07/16/2024

Il metodo GraphicsPath::AddCurve aggiunge una spline cardinale alla figura corrente di questo percorso.

Sintassi

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

Parametri

points

Puntatore a una matrice di punti che definiscono la spline cardinale. La spline cardinal è una curva che passa attraverso ogni punto della matrice.

count

Integer che specifica il numero di elementi nella matrice di punti.

Valore restituito

Tipo di :stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status.

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status.

Osservazioni

Se questi punti saranno necessari in un secondo momento, è necessario conservare una copia della matrice di punti. L'oggetto GraphicsPath non archivia i punti passati al metodo AddClosedCurve ; Converte invece la spline cardinali in una sequenza di spline di Bézier e archivia i punti che definiscono le spline di Bézier. Non è possibile recuperare la matrice originale di punti dall'oggetto GraphicsPath.

Esempi

Nell'esempio seguente viene creato un Percorso oggetto GraphicsPath, viene aggiunto uno spline cardinale al percorso e quindi viene disegnato il percorso.

VOID AddCurveExample(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.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}