SubtractRect-Funktion (winuser.h)
Die SubtractRect-Funktion bestimmt die Koordinaten eines Rechtecks, das durch Subtrahieren eines Rechtecks von einem anderen gebildet wird.
Syntax
BOOL SubtractRect(
[out] LPRECT lprcDst,
[in] const RECT *lprcSrc1,
[in] const RECT *lprcSrc2
);
Parameter
[out] lprcDst
Ein Zeiger auf eine RECT-Struktur , die die Koordinaten des Rechtecks empfängt, die durch Subtrahieren des Rechtecks bestimmt werden, auf das von lprcSrc2 verwiesen wird, von dem Rechteck, auf das von lprcSrc1 verwiesen wird.
[in] lprcSrc1
Ein Zeiger auf eine RECT-Struktur , von der die Funktion das Rechteck subtrahiert, auf das von lprcSrc2 verwiesen wird.
[in] lprcSrc2
Ein Zeiger auf eine RECT-Struktur , die die Funktion vom Rechteck subtrahiert, auf das lprcSrc1 verweist.
Rückgabewert
Wenn das resultierende Rechteck leer ist, ist der Rückgabewert 0.
Wenn das resultierende Rechteck nicht leer ist, ist der Rückgabewert nonzero.
Hinweise
Die Funktion subtrahiert das von lprcSrc2 angegebene Rechteck nur von dem durch lprcSrc1 angegebenen Rechteck, wenn sich die Rechtecke vollständig in x- oder y-Richtung überschneiden. Wenn *lprcSrc1 beispielsweise die Koordinaten (10,10,100,100) und *lprcSrc2 die Koordinaten (50,50,150,150,150) aufweist, legt die Funktion die Koordinaten des Rechtecks fest, auf das von lprcDst verwiesen wird, auf (10,10,100,100). Wenn *lprcSrc1 über die Koordinaten (10,10,100,100) und *lprcSrc2 über die Koordinaten (50,10,150,150) verfügt, legt die Funktion jedoch die Koordinaten des Rechtecks fest, auf das von lprcDst verwiesen wird, auf (10,10,50,100). Mit anderen Worten, das resultierende Rechteck ist das umgebende Feld der geometrischen Differenz.
Da Anwendungen Rechtecke für verschiedene Zwecke verwenden können, verwenden die Rechteckfunktionen keine explizite Maßeinheit. Stattdessen werden alle Rechteckkoordinaten und Dimensionen in signierten logischen Werten angegeben. Der Zuordnungsmodus und die Funktion, in der das Rechteck verwendet wird, bestimmen die Maßeinheiten.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |