wingdi.h


CombineRgn

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

Sintaxis

int CombineRgn(
    HRGN hrgnDest,     // manipulador a región de destino
    HRGN hrgnSrc1,     // manipulador a región de origen
    HRGN hrgnSrc2,     // manipulador a región de origen
    int fnCombineMode  // modi de combinación de regiones
   );

Parámetros

hrgnDest: identifica una nueva región con dimensiones definidas por la combinación de otras dos. (Esta región debe existir antes de que la función CombineRgn sea llamada.)

hrgnSrc1: identifica la primera de las dos regiones a combinar.

hrgnSrc2: identifica la segunda de las dos regiones a combinar.

fnCombineMode: especifica el modo que indica cómo se combinarán las dos regiones. Este parámetro puede tener uno de los siguientes valores:

Valor Descripción
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 Toma las partes de hrgnSrc1 que no forman parte de hrgnSrc2.
RGN_OR Unión de las dos regiones combinadas.
RGN_XOR Unión de las dos regiones combinadas, exceptuando cualquier área superpuesta.

Valor de retorno

El valor de retorno especifia el tipo de región resultante. Puede ser uno de los siguientes valores:

Valor Significado
NULLREGION La región está vacía.
SIMPLEREGION La región es un rectángulo simple.
COMPLEXREGION La región está formada por más de un rectángulo simple.
ERROR No se ha creado una región.

Observaciones

Las tres regiones no tienen por qué ser distintas. Por ejemplo, el parámetro hrgnSrc1 puede ser igual que el parámetro hrgnDest.