PolyPolygon, fonction (wingdi.h)

Article
03/13/2024

La fonction PolyPolygon dessine une série de polygones fermés. Chaque polygone est tracé à l’aide du stylet actuel et rempli à l’aide du mode de remplissage actuel du pinceau et du polygone. Les polygones dessinés par cette fonction peuvent se chevaucher.

Syntaxe

BOOL PolyPolygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const INT   *asz,
  [in] int         csz
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] apt

Pointeur vers un tableau de structures POINT qui définissent les sommets des polygones, en coordonnées logiques. Les polygones sont spécifiés consécutivement. Chaque polygone est fermé automatiquement en dessinant une ligne du dernier sommet au premier. Chaque sommet doit être spécifié une seule fois.

[in] asz

Pointeur vers un tableau d’entiers, chacun spécifiant le nombre de points dans le polygone correspondant. Chaque entier doit être supérieur ou égal à 2.

[in] csz

Nombre total de polygones.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

La position actuelle n’est ni utilisée ni mise à jour par cette fonction.

Tous les points supplémentaires sont ignorés. Pour dessiner les polygones avec plus de points, divisez vos données en groupes, chacun ayant moins de points que le nombre maximal de points, et appelez la fonction pour chaque groupe de points. Notez qu’il est préférable d’avoir un polygone dans un seul des groupes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	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	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll