Partager via


Fonction CreatePolyPolygonRgn (wingdi.h)

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

Voir aussi

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

POINT

Fonctions de région

Vue d’ensemble des régions

SélectionnerObject

SetPolyFillMode