Función CombineRgn (wingdi.h)

Artículo
03/04/2024

La función CombineRgn combina dos regiones y almacena el resultado en una tercera región. Las dos regiones se combinan según el modo especificado.

Sintaxis

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

Parámetros

[in] hrgnDst

Identificador de una nueva región con dimensiones definidas mediante la combinación de otras dos regiones. (Esta región debe existir antes de llamar a CombineRgn ).

[in] hrgnSrc1

Identificador de las dos primeras regiones que se van a combinar.

[in] hrgnSrc2

Identificador del segundo de dos regiones que se van a combinar.

[in] iMode

Modo que indica cómo se combinarán las dos regiones. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
RGN_AND	Crea la intersección de las dos regiones combinadas.
RGN_COPY	Crea una copia de la región identificada por hrgnSrc1.
RGN_DIFF	Combina las partes de hrgnSrc1 que no forman parte de hrgnSrc2.
RGN_OR	Crea la unión de dos regiones combinadas.
RGN_XOR	Crea la unión de dos regiones combinadas, excepto para las áreas superpuestas.

Valor devuelto

El valor devuelto especifica el tipo de la región resultante. Puede ser uno de los siguientes valores.

Código devuelto	Descripción
NULLREGION	La región está vacía.
SIMPLEREGION	La región es un único rectángulo.
COMPLEXREGION	La región es más de un solo rectángulo.
ERROR	No se crea ninguna región.

Comentarios

Las tres regiones no deben ser distintas. Por ejemplo, el parámetro hrgnSrc1 puede ser igual al parámetro hrgnDest .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll