Metodo GraphicsPath::AddClosedCurve(constPoint*,INT,REAL) (gdipluspath.h)

Articolo
02/29/2024

Il metodo GraphicsPath::AddClosedCurve aggiunge una spline cardinal chiusa a questo percorso.

Sintassi

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

Parametri

[in] points

Tipo: punto* const

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

[in] count

Tipo: INT

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

[in] tension

Tipo: REAL

Numero reale nonnegative che controlla la lunghezza della curva e come si piega la curva. Un valore pari a 0 specifica che la spline è una sequenza di linee dritte. Quando il valore aumenta, la curva diventa più completa.

Valore restituito

Tipo: Stato

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

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

Commenti

È consigliabile mantenere una copia della matrice di punti se questi punti saranno necessari in un secondo momento. L'oggetto GraphicsPath non archivia i punti passati al metodo GraphicsPath::AddClosedCurve ; converte invece la spline cardinali in una sequenza di spline bézier e archivia i punti che definiscono gli spline bézier. Non è possibile recuperare la matrice originale di punti dall'oggetto GraphicsPath .

Esempio

Nell'esempio seguente viene creato un percorso dell'oggetto GraphicsPath, viene aggiunto uno spline cardinal chiuso al percorso e quindi si disegna il percorso. La tensione è impostata su 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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll