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

Articolo
03/16/2023

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

Sintassi

Status AddPolygon(
  [in] const Point *points,
  [in] INT         count
);

Parametri

[in] points

Tipo: punto* const

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

[in] count

Tipo: INT

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

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

Il metodo GraphicsPath::AddPolygon è simile al metodo AddLines . La differenza è che un poligono è una figura intrinsecamente chiusa, ma una sequenza di righe 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; vale a dire, l'ultimo vertice del poligono è connesso al primo vertice in base a una linea retta.

Esempio

L'esempio seguente crea un percorso oggetto GraphicsPath, aggiunge un poligono al percorso e quindi disegna il percorso.

VOID Example_AddPolygon(HDC hdc)
{
   Graphics graphics(hdc); 
 
   Point pts[] = {Point(20, 20),
                  Point(120, 20),
                  Point(120, 70)};

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

   // 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