wingdi.h


ExcludeClipRect

La función ExcludeClipRect crea una región de recorte nueva que consiste en la región de recorte existente menos el rectángulo especificado.

Sintaxis

int ExcludeClipRect(
    HDC hdc,         // manipulador de contexto de dispositivo
    int nLeftRect,   // coordenada x de la esquina superior izquierda del rectángulo
    int nTopRect,    // coordenada y de la esquina superior izquierda del rectángulo
    int nRightRect,  // coordenada x de la esquina inferior derecha del rectángulo
    int nBottomRect  // coordenada y de la esquina inferior derecha del rectángulo
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

nLeftRect: especifica la coordenada x lógica de la esquina superior izquierda del rectángulo.

nTopRect: especifica la coordenada y lógica de la esquina superior izquierda del rectángulo.

nRightRect: especifica la coordenada x lógica de la esquina inferior derecha del rectángulo.

nBottomRect: especifica la coordenada y lógica de la esquina inferior derecha del rectángulo.

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 No se ha creado ninguna región.

Observaciones

Los bordes inferior y derecho del rectángulo especificado no se excluyen de la región de recorte.