Función SubtractRect (winuser.h)
La función SubtractRect determina las coordenadas de un rectángulo formado restando un rectángulo de otro.
Sintaxis
BOOL SubtractRect(
[out] LPRECT lprcDst,
[in] const RECT *lprcSrc1,
[in] const RECT *lprcSrc2
);
Parámetros
[out] lprcDst
Puntero a una estructura RECT que recibe las coordenadas del rectángulo determinado restando el rectángulo al que apunta lprcSrc2 del rectángulo al que apunta lprcSrc1.
[in] lprcSrc1
Puntero a una estructura RECT de la que la función resta el rectángulo al que apunta lprcSrc2.
[in] lprcSrc2
Puntero a una estructura RECT a la que la función resta del rectángulo al que apunta lprcSrc1.
Valor devuelto
Si el rectángulo resultante está vacío, el valor devuelto es cero.
Si el rectángulo resultante no está vacío, el valor devuelto es distinto de cero.
Observaciones
La función solo resta el rectángulo especificado por lprcSrc2 del rectángulo especificado por lprcSrc1 cuando los rectángulos se intersecan por completo en la dirección x o y. Por ejemplo, si *lprcSrc1 tiene las coordenadas (10 10 100 100 100) y *lprcSrc2 tienen las coordenadas (50 50 50 150 150), la función establece las coordenadas del rectángulo al que apunta lprcDst en (10 10 100 100 100). Si *lprcSrc1 tiene las coordenadas (10,10,100,100) y *lprcSrc2 tiene las coordenadas (50,10,150,150), sin embargo, la función establece las coordenadas del rectángulo señalado por lprcDst en (10,10,50,100). En otras palabras, el rectángulo resultante es el rectángulo delimitador de la diferencia geométrica.
Dado que las aplicaciones pueden usar rectángulos para diferentes propósitos, las funciones de rectángulo no usan una unidad de medida explícita. En su lugar, todas las coordenadas y dimensiones del rectángulo se proporcionan en valores lógicos con signo. El modo de asignación y la función en la que se usa el rectángulo determinan las unidades de medida.
Requisitos
| 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 | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |