Función ExtSelectClipRgn (wingdi.h)

  • Artículo

La función ExtSelectClipRgn combina la región especificada con la región de recorte actual mediante el modo especificado.

Sintaxis

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] hrgn

Identificador de la región que se va a seleccionar. Este identificador no debe ser NULL a menos que se especifique el modo de RGN_COPY.

[in] mode

La operación que se va a realizar. Debe tener uno de los siguientes valores.

Valor Significado
RGN_AND
 La nueva región de recorte combina las áreas superpuestas de la región de recorte actual y la región identificada por hrgn.
RGN_COPY
 La nueva región de recorte es una copia de la región identificada por hrgn. Esto es idéntico a SelectClipRgn. Si la región identificada por hrgn es NULL, la nueva región de recorte es la región de recorte predeterminada (la región de recorte predeterminada es una región nula).
RGN_DIFF
 La nueva región de recorte combina las áreas de la región de recorte actual con esas áreas excluidas de la región identificadas por hrgn.
RGN_OR
 La nueva región de recorte combina la región de recorte actual y la región identificada por hrgn.
RGN_XOR
 La nueva región de recorte combina la región de recorte actual y la región identificada por hrgn , pero excluye las áreas superpuestas.

Valor devuelto

El valor devuelto especifica la complejidad de la nueva región de recorte; puede ser uno de los valores siguientes.

Código devuelto Descripción
NULLREGION
 La región está vacía.
SIMPLEREGION
 La región es un único rectángulo.
COMPLEXREGION
 La región es más de un rectángulo.
ERROR
 Se produjo un error.

Comentarios

Si se produce un error cuando se llama a esta función, la región de recorte anterior del contexto de dispositivo especificado no se ve afectada.

La función ExtSelectClipRgn supone que las coordenadas de la región especificada se especifican en unidades de dispositivo.

Solo se usa una copia de la región identificada por el parámetro hrgn . La propia región se puede reutilizar después de esta llamada o se puede eliminar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

Funciones de recorte

Información general sobre el recorte

SelectClipRgn