SetRect-Funktion (winuser.h)

Artikel
04.03.2024

Die SetRect-Funktion legt die Koordinaten des angegebenen Rechtecks fest. Dies entspricht dem Zuweisen der linken, oberen, rechten und unteren Argumente zu den entsprechenden Membern der RECT-Struktur .

Syntax

BOOL SetRect(
  [out] LPRECT lprc,
  [in]  int    xLeft,
  [in]  int    yTop,
  [in]  int    xRight,
  [in]  int    yBottom
);

Parameter

[out] lprc

Zeiger auf die RECT-Struktur , die das festzulegende Rechteck enthält.

[in] xLeft

Gibt die x-Koordinate der oberen linken Ecke des Rechtecks an.

[in] yTop

Gibt die y-Koordinate der linken oberen Ecke des Rechtecks an.

[in] xRight

Gibt die x-Koordinate der rechten unteren Ecke des Rechtecks an.

[in] yBottom

Gibt die y-Koordinate der unteren rechten Ecke des Rechtecks an.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

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

Anforderung	Wert
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