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

Articolo
07/16/2024

Il metodo GraphicsPath::AddPolygon aggiunge un poligono a questo percorso.

Sintassi

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

Parametri

points

Puntatore a una matrice di punti che specifica i vertici del poligono.

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

Il metodo GraphicsPath::AddPolygon è simile al metodo AddLines. La differenza è che un poligono è una figura intrinsecamente chiusa, ma una sequenza di linee non è una figura chiusa a meno che non si chiami GraphicsPath::CloseFigure. Quando Windows GDI+ esegue il rendering di un percorso, ogni poligono in tale percorso viene chiuso; ovvero, l'ultimo vertice del poligono è collegato al primo vertice da una linea retta.

Esempi

Nell'esempio seguente viene creato un GraphicsPath percorso oggetto, viene aggiunto un poligono al percorso e quindi viene disegnato il percorso.

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

   PointF pts[] = {PointF(20.0f, 20.0f),
                   PointF(120.0f, 20.0f),
                   PointF(120.0f, 70.0f)};

   GraphicsPath path;
   path.AddPolygon(pts, 3);

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