Partager via


Fonction CombineRgn (wingdi.h)

La fonction CombineRgn combine deux régions et stocke le résultat dans une troisième région. Les deux régions sont combinées selon le mode spécifié.

Syntaxe

int CombineRgn(
  [in] HRGN hrgnDst,
  [in] HRGN hrgnSrc1,
  [in] HRGN hrgnSrc2,
  [in] int  iMode
);

Paramètres

[in] hrgnDst

Handle vers une nouvelle région avec des dimensions définies en combinant deux autres régions. (Cette région doit exister avant l’appel de CombineRgn .)

[in] hrgnSrc1

Handle vers la première des deux régions à combiner.

[in] hrgnSrc2

Handle à la deuxième des deux régions à combiner.

[in] iMode

Mode indiquant comment les deux régions seront combinées. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
RGN_AND
Crée l’intersection des deux régions combinées.
RGN_COPY
Crée une copie de la région identifiée par hrgnSrc1.
RGN_DIFF
Combine les parties de hrgnSrc1 qui ne font pas partie de hrgnSrc2.
RGN_OR
Crée l’union de deux régions combinées.
RGN_XOR
Crée l’union de deux régions combinées à l’exception des zones qui se chevauchent.

Valeur retournée

La valeur de retour spécifie le type de la région résultante. Il peut avoir l’une des valeurs suivantes.

Code de retour Description
NULLREGION
La région est vide.
SIMPLEREGION
La région est un rectangle unique.
COMPLEXREGION
La région est plus qu’un rectangle unique.
ERROR
Aucune région n’est créée.

Remarques

Les trois régions ne doivent pas nécessairement être distinctes. Par exemple, le paramètre hrgnSrc1 peut être égal au paramètre hrgnDest .

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

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

Fonctions de région

Vue d’ensemble des régions