Fonction CreatePolyPolygonRgn (wingdi.h)

Article
03/04/2024

La fonction CreatePolyPolygonRgn crée une région composée d’une série de polygones. Les polygones peuvent se chevaucher.

Syntaxe

HRGN CreatePolyPolygonRgn(
  [in] const POINT *pptl,
  [in] const INT   *pc,
  [in] int         cPoly,
  [in] int         iMode
);

Paramètres

[in] pptl

Pointeur vers un tableau de structures POINT qui définissent les sommets des polygones en unités logiques. Les polygones sont spécifiés consécutivement. Chaque polygone est présumé fermé et chaque sommet n’est spécifié qu’une seule fois.

[in] pc

Pointeur vers un tableau d’entiers, chacun d’eux spécifiant le nombre de points dans l’un des polygones du tableau pointé vers lppt.

[in] cPoly

Nombre total d’entiers dans le tableau pointé vers lpPolyCounts.

[in] iMode

Mode de remplissage utilisé pour déterminer quels pixels se trouvent dans la région. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
ALTERNATIVE	Sélectionne un autre mode (remplit la zone entre les côtés impairs et pairs des polygones sur chaque ligne de balayage).
ENROULEMENT	Sélectionne le mode d’enroulement (remplit n’importe quelle région avec une valeur d’enroulement différente de zéro).

Pour plus d’informations sur ces modes, consultez la fonction SetPolyFillMode .

Valeur retournée

Si la fonction réussit, la valeur de retour est le handle de la région.

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

Remarques

Lorsque vous n’avez plus besoin de l’objet HRGN , appelez la fonction DeleteObject pour le supprimer.

Les coordonnées de région sont représentées sous forme d’entiers signés 27 bits.

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