OffsetRect-Funktion (winuser.h)
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 |