winuser.h


SubtractRect

La función SubtractRect obtiene las coordenadas de un rectángulo determinado por la resta de un rectángulo de otro.

Sintaxis

BOOL SubtractRect(
    LPRECT lprcDst,        // puntero al rectángulo de destino
    CONST RECT *lprcSrc1,  // puntero al rectángulo del que se resta
    CONST RECT *lprcSrc2   // puntero al rectángulo a restar
   );

Parámetros

lprcDst: apunta a una estructura RECT que recibe las coordenadas del rectángulo determinado por la resta del rectángulo apuntado por lprcSrc2 del rectángulo apuntado por lprcSrc1.

lprcSrc1: apunta a una estructura RECT desde el que se restará el rectángulo apuntado por lprcSrc2.

lprcSrc2: apunta a una estructura RECT que la función restará del rectángulo apuntado por lprcSrc1.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero.

Observaciones

La función sólo resta el rectángulo especificado por lprcSrc2 del rectángulo especificado por lprcSrc1 cuando los rectángulos se interseccionan por completo en la dirección x o en la y. Por ejemplo, si *lprcSrc1 tiene las coordenadas (10,10,100,100) y *lprcSrc2 tiene las coordenadas (50,50,150,150), la función asigna a las coordenadas del rectángulo apuntado pro lprcDst a (10,10,100,100). Pero si *lprcSrc1 tiene las coordenadas (10,10,100,100) y *lprcSrc2 tiene las coordenadas (50,10,150,150), la función asigna a las coordenadas del rectángulo apuntado por lprcDst (10,10,50,100).