Fonction CombineRgn (wingdi.h)

Article
08/27/2023

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