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.