ExtSelectClipRgn
La función ExtSelectClipRgn combina la región especificada con la región de recorte actual usando el modo especificado.
Sintaxis
int ExtSelectClipRgn(
HDC hdc, // manipulador de contexto de dispositivo
HRGN hrgn, // manipulador de región
int fnMode // modo de selección de región
);
Parámetros:
hdc: identifica el contexto de dispositivo.
hrgn: identifica la región a seleccionar. Este manipulador sólo puede ser NULL cuando se especifica el modo RGN_COPY.
fnMode: especifica la operación a realizar. Debe ser uno de los siguientes valores:
| Valor | Significado |
|---|---|
| RGN_AND | La nueva región de recorte se compone de las áreas superpuestas de la región de recorte actual y la región identificada mediante hrgn. |
| RGN_COPY | La nueva región de recorte es una copia de la identificada por hrgn. Esto es lo mismo que usar SelectClipRgn. Si la región identificada por hrgn es NULL, la nueva región de recorte es la región de recorte por defecto (que es una región nula). |
| RGN_DIFF | La nueva región de recorte se compone de las áreas de la región de recorte actual excluyendo las de la región identificada por hrgn. |
| RGN_OR | La nueva región de recorte une la región de recorte actual y la región identificada por hrgn. |
| RGN_XOR | La nueva región de recorte se compone de la suma de las áreas en la región de recorte actual y la identificada por hrgn, pero excluye las áreas superpuestas. |
Valor de retorno
Si la función tiene éxito, el valor de retorno especifica la complejidad de la nueva región de recorte, y puede ser uno de los siguientes valores:
| Valor | Significado |
|---|---|
| NULLREGION | La región está vacía. |
| SIMPLEREGION | La región es un rectángulo. |
| COMPLEXREGION | La región es más de un rectángulo. |
| ERROR | Se ha producido un error. |
Observaciones
Si se produce un error cuando se llama a esta función, la región de recorte previa para el contexto de dispositivo especificado no se ve afectada.
La función ExtSelectClipRgn asume que las coordenadas de la región especificada se especifican en unidades de dispositivo.
Sólo se usa una copia de la región especificada por el parámetro hrgn. La región en si se puede usar después de esta llamada o puede ser borrada.