Función CombineRgn (wingdi.h)

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

Consulte también

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

Funciones de región

Introducción a las regiones