OffsetRect-Funktion (winuser.h)

Artikel
08/27/2023

Die OffsetRect-Funktion verschiebt das angegebene Rechteck um die angegebenen Offsets.

Syntax

BOOL OffsetRect(
  [in, out] LPRECT lprc,
  [in]      int    dx,
  [in]      int    dy
);

Parameter

[in, out] lprc

Zeiger auf eine RECT-Struktur , die die logischen Koordinaten des zu verschiebenden Rechtecks enthält.

[in] dx

Gibt den Betrag an, der das Rechteck nach links oder rechts verschoben werden soll. Dieser Parameter muss ein negativer Wert sein, um das Rechteck nach links zu verschieben.

[in] dy

Gibt den Betrag an, der das Rechteck nach oben oder unten verschoben werden soll. Dieser Parameter muss ein negativer Wert sein, um das Rechteck nach oben zu verschieben.

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 Rechtecks.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll