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

Siehe auch

Konzept

GetWindowPlacement

Referenz

WINDOWPLACEMENT

Windows