Fonction CreatePolygonRgn (wingdi.h)

Article
08/27/2023

La fonction CreatePolygonRgn crée une région polygonale.

Syntaxe

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

Paramètres

[in] pptl

Pointeur vers un tableau de structures POINT qui définissent les sommets du polygone en unités logiques. Le polygone est présumé fermé. Chaque sommet ne peut être spécifié qu’une seule fois.

[in] cPoint

Nombre de points dans le tableau.

[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 NULL.

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.

Les régions créées par les méthodes Create<shape>Rgn (telles que CreateRectRgn et CreatePolygonRgn) incluent uniquement l’intérieur de la forme ; le contour de la forme est exclu de la région. Cela signifie que tout point sur une ligne entre deux sommets séquentiels n’est pas inclus dans la région. Si vous deviez appeler PtInRegion pour un tel point, il retournerait zéro comme résultat.

Configuration requise


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