wingdi.h


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.