GraphicsPath ::AddPolygon(constPointF*,INT), méthode (gdipluspath.h)

Article
03/02/2024

La méthode GraphicsPath ::AddPolygon ajoute un polygone à ce chemin.

Syntaxe

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

Paramètres

points

Pointeur vers un tableau de points qui spécifie les sommets du polygone.

count

Entier qui spécifie le nombre d’éléments dans le tableau de points.

Valeur retournée

Type :Status

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

La méthode GraphicsPath ::AddPolygon est similaire à la méthode AddLines . La différence est qu’un polygone est une figure intrinsèquement fermée, mais une séquence de lignes n’est pas une figure fermée, sauf si vous appelez GraphicsPath ::CloseFigure. Lorsque Windows GDI+ affiche un chemin d’accès, chaque polygone de ce chemin est fermé ; Autrement dit, le dernier sommet du polygone est connecté au premier sommet par une ligne droite.

Exemples

L’exemple suivant crée un chemin d’objet GraphicsPath , ajoute un polygone au chemin, puis dessine le chemin.

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);
}