wingdi.h


SetMetaRgn

La función SetMetaRgn realiza la intersección entre la región de recorte actual del contexto de dispositivo especificado con la metaregión actual, y guarda la región resultante como la nueva metaregión para el contexto de dispositivo especificado. La región de recorte se anula.

Sintaxis

int SetMetaRgn(
    HDC hdc  // manipulador de contexto de dispositivo
   );

Parámetros

hdc: identifica el contexto de dispositivo.

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

La región de recorte actual de un contexto de dispositivo se define por la intersección de su región de recorte y su metaregión.

La función SetMetaRgn sólo debe ser llamada después de que el contexto de dispositivo original de la aplicación haya sido guardado usando la función SaveDC.