IntersectRect-Funktion (winuser.h)

Artikel
08/27/2023

Die IntersectRect-Funktion berechnet die Schnittmenge von zwei Quellrechtecken und platziert die Koordinaten des Schnittpunktrechtecks im Zielrechteck. Wenn sich die Quellrechtecke nicht überschneiden, wird ein leeres Rechteck (in dem alle Koordinaten auf Null festgelegt sind) im Zielrechteck platziert.

Syntax

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

Parameter

[out] lprcDst

Ein Zeiger auf die RECT-Struktur , die die Schnittmenge der Rechtecke empfangen soll, auf die von den Parametern lprcSrc1 und lprcSrc2 verwiesen wird. Dieser Parameter darf nicht NULL sein.

[in] lprcSrc1

Ein Zeiger auf die RECT-Struktur , die das erste Quellrechteck enthält.

[in] lprcSrc2

Ein Zeiger auf die RECT-Struktur , die das zweite Quellrechteck enthält.

Rückgabewert

Wenn sich die Rechtecke überschneiden, ist der Rückgabewert nichtzero.

Wenn sich die Rechtecke nicht überschneiden, ist der Rückgabewert 0.

Hinweise

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.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Rechtecken.

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