wingdi.h


SelectClipRgn

La función SelectClipRgn selecciona una región como la región de recorte actual para el contexto de dispositivo especificado.

Sintaxis

int SelectClipRgn(
    HDC hdc,   // manipulador de contexto de dispositivo
    HRGN hrgn  // manipulador de región a seleccionar
   );

Parámetros

hdc: identifica el contexto de dispositivo.

hrgn: identifica la región a seleccionar.

Valor de retorno

Si la función tiene éxito, el valor de retorno especifica la complejidad de la región 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 Ha ocurrido un error. (La región de recorte previa no se ve afectada.)

Observaciones

Sólo se usa una copia de la región seleccionada. La región misma puede ser seleccionada para cualquier número de contextos de dispositivo o puede ser borrada.

La función SelectClipRgn asume que las coordenadas de una región se especifican en unidades de dispositivo.

Para eliminar una región de recorte de un contexto de dispositivo, especificar un manipulador de región NULL.