SubtractRect-Funktion (winuser.h)

Artikel
08/28/2023

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