Funzione CombineRgn (wingdi.h)

Articolo
03/04/2024

La funzione CombineRgn combina due aree e archivia il risultato in una terza area. Le due aree vengono combinate in base alla modalità specificata.

Sintassi

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

Parametri

[in] hrgnDst

Handle per una nuova area con dimensioni definite combinando due altre aree. Questa area deve esistere prima della chiamata a CombineRgn .

[in] hrgnSrc1

Handle per la prima di due aree da combinare.

[in] hrgnSrc2

Handle per il secondo di due aree da combinare.

[in] iMode

Modalità che indica come verranno combinate le due aree. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
RGN_AND	Crea l'intersezione delle due aree combinate.
RGN_COPY	Crea una copia dell'area identificata da hrgnSrc1.
RGN_DIFF	Combina le parti di hrgnSrc1 che non fanno parte di hrgnSrc2.
RGN_OR	Crea l'unione di due aree combinate.
RGN_XOR	Crea l'unione di due aree combinate ad eccezione di eventuali aree sovrapposte.

Valore restituito

Il valore restituito specifica il tipo dell'area risultante. Può essere uno dei valori seguenti.

Codice restituito	Descrizione
NULLREGION	L'area è vuota.
SIMPLEREGION	L'area è un singolo rettangolo.
COMPLEXREGION	L'area è più di un singolo rettangolo.
ERROR	Non viene creata alcuna area.

Commenti

Le tre aree non devono essere distinte. Ad esempio, il parametro hrgnSrc1 può essere uguale al parametro hrgnDest .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll