Funzione SubtractRect (winuser.h)

La funzione SubtractRect determina le coordinate di un rettangolo formato sottraendo un rettangolo da un altro.

Sintassi

BOOL SubtractRect(
  [out] LPRECT     lprcDst,
  [in]  const RECT *lprcSrc1,
  [in]  const RECT *lprcSrc2
);

Parametri

[out] lprcDst

Puntatore a una struttura RECT che riceve le coordinate del rettangolo determinato sottraendo il rettangolo a cui punta lprcSrc2 dal rettangolo a cui punta lprcSrc1.

[in] lprcSrc1

Puntatore a una struttura RECT da cui la funzione sottrae il rettangolo a cui punta lprcSrc2.

[in] lprcSrc2

Puntatore a una struttura RECT che la funzione sottrae dal rettangolo a cui punta lprcSrc1.

Valore restituito

Se il rettangolo risultante è vuoto, il valore restituito è zero.

Se il rettangolo risultante non è vuoto, il valore restituito è diverso da zero.

Commenti

La funzione sottrae solo il rettangolo specificato da lprcSrc2 dal rettangolo specificato da lprcSrc1 quando i rettangoli intersecano completamente nella direzione x o y. Ad esempio, se *lprcSrc1 ha le coordinate (10,10,100,100) e *lprcSrc2 ha le coordinate (50,50,150,150), la funzione imposta le coordinate del rettangolo a cui punta lprcDst su (10,10,100,100,100). Se *lprcSrc1 ha le coordinate (10,10,100,100) e *lprcSrc2 ha le coordinate (50,10,150,150), tuttavia, la funzione imposta le coordinate del rettangolo a cui punta lprcDst su (10,10,50,100,100). In altre parole, il rettangolo risultante è il rettangolo delimitatore della differenza geometrica.

Poiché le applicazioni possono usare rettangoli per scopi diversi, le funzioni rettangolo non usano un'unità di misura esplicita. Vengono invece specificate tutte le coordinate e le dimensioni del rettangolo in valori logici con segno. La modalità di mapping e la funzione in cui viene utilizzato il rettangolo determinano le unità di misura.

Requisiti

Vedi anche

IntersectRect

RECT

Funzioni rettangolo

Panoramica dei rettangoli

UnionRect