SetWindowPlacement-Funktion (winuser.h)
Legt den Showstatus und die wiederhergestellten, minimierten und maximierten Positionen des angegebenen Fensters fest.
Syntax
BOOL SetWindowPlacement(
[in] HWND hWnd,
[in] const WINDOWPLACEMENT *lpwndpl
);
Parameter
[in] hWnd
Typ: HWND
Ein Handle für das Fenster.
[in] lpwndpl
Typ: const WINDOWPLACEMENT*
Ein Zeiger auf eine WINDOWPLACEMENT-Struktur , die den neuen Anzeigezustand und die Fensterpositionen angibt.
Legen Sie vor dem Aufrufen von SetWindowPlacement das Längenelement der WINDOWPLACEMENT-Struktur auf sizeof(WINDOWPLACEMENT) fest. SetWindowPlacement schlägt fehl, wenn das Längenelement nicht ordnungsgemäß festgelegt ist.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn die in WINDOWPLACEMENT angegebenen Informationen zu einem Fenster führen würden, das sich vollständig außerhalb des Bildschirms befindet, passt das System die Koordinaten automatisch an, sodass das Fenster sichtbar ist, wobei Änderungen in der Bildschirmauflösung und der Konfiguration mehrerer Monitore berücksichtigt werden.
Das Längenelement von WINDOWPLACEMENT muss auf sizeof(WINDOWPLACEMENT)festgelegt werden. Wenn dieser Member nicht ordnungsgemäß festgelegt ist, gibt die Funktion FALSE zurück. Weitere Hinweise zur ordnungsgemäßen Verwendung von Fensterplatzierungskoordinaten finden Sie unter WINDOWPLACEMENT.
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 |
| APIs | ext-ms-win-ntuser-window-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240) |
Siehe auch
Konzept
Referenz