AdjustWindowRect-Funktion (winuser.h)

Artikel
08/27/2023

Berechnet die erforderliche Größe des Fensterrechtecks basierend auf der gewünschten Clientrechteckgröße. Das Fensterrechteck kann dann an die CreateWindow-Funktion übergeben werden, um ein Fenster zu erstellen, dessen Clientbereich die gewünschte Größe aufweist.

Verwenden Sie die Funktion AdjustWindowRectEx , um ein erweitertes Fensterformat anzugeben.

Syntax

BOOL AdjustWindowRect(
  [in, out] LPRECT lpRect,
  [in]      DWORD  dwStyle,
  [in]      BOOL   bMenu
);

Parameter

[in, out] lpRect

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , die die Koordinaten der oberen linken und unteren rechten Ecke des gewünschten Clientbereichs enthält. Wenn die Funktion zurückgibt, enthält die Struktur die Koordinaten der oberen linken und unteren rechten Ecke des Fensters, um den gewünschten Clientbereich zu berücksichtigen.

[in] dwStyle

Art: DWORD

Der Fensterstil des Fensters, dessen erforderliche Größe berechnet werden soll. Beachten Sie, dass Sie die WS_OVERLAPPED Formatvorlage nicht angeben können.

[in] bMenu

Typ: BOOL

Gibt an, ob das Fenster über ein Menü verfügt.

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

Ein Clientrechteck ist das kleinste Rechteck, das einen Clientbereich vollständig umschließt. Ein Fensterrechteck ist das kleinste Rechteck, das das Fenster vollständig umschließt, das den Clientbereich und den Nichtclientbereich umfasst.

Die Funktion AdjustWindowRect fügt keinen zusätzlichen Abstand hinzu, wenn eine Menüleiste in zwei oder mehr Zeilen umgebrochen wird.

Die Funktion AdjustWindowRect berücksichtigt nicht die stile WS_VSCROLL oder WS_HSCROLL . Rufen Sie die GetSystemMetrics-Funktion mit SM_CXVSCROLL oder SM_CYHSCROLL auf, um die Bildlaufleisten zu berücksichtigen.

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
APIs	ext-ms-win-ntuser-window-l1-1-4 (eingeführt in Windows 10, Version 10.0.14393)