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

Article
02/26/2024

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

Syntaxe

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

Paramètres

[in] points

Type : const Point*

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

[in] count

Type : INT

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

Valeur retournée

Type : État

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdipluspath.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll