Partager via


Fonction CreatePolygonRgn (wingdi.h)

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

Voir aussi

CreatePolyPolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

POINT

Fonctions de région

Vue d’ensemble des régions

SélectionnerObject

SetPolyFillMode