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

Consulte también

IntersectRect

RECT

Funciones de rectángulo

Información general sobre rectángulos

UnionRect