AdjustWindowRectEx-Funktion (winuser.h)

Artikel
03/06/2024

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

Syntax

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

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ückgegeben wird, enthält die Struktur die Koordinaten der oberen linken und unteren rechten Ecken des Fensters, um den gewünschten Clientbereich aufzunehmen.

[in] dwStyle

Art: DWORD

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

[in] bMenu

Typ: BOOL

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

[in] dwExStyle

Art: DWORD

Der erweiterte Fensterstil des Fensters, dessen erforderliche Größe berechnet werden soll.

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 AdjustWindowRectEx fügt keinen zusätzlichen Speicherplatz hinzu, wenn eine Menüleiste in zwei oder mehr Zeilen umschließt.

Die AdjustWindowRectEx-Funktion berücksichtigt nicht die stile WS_VSCROLL oder WS_HSCROLL . Um die Bildlaufleisten zu berücksichtigen, rufen Sie die GetSystemMetrics-Funktion mit SM_CXVSCROLL oder SM_CYHSCROLL auf.

Diese API ist nicht DPI-fähig und sollte nicht verwendet werden, wenn der aufrufende Thread pro Monitor DPI-Wert aufweist. Die DPI-fähige Version dieser API finden Sie unter AdjustWindowsRectExForDPI. Weitere Informationen zur DPI-Sensibilisierung finden Sie in der Dokumentation zu Windows High DPI.

Anforderungen

Anforderung	Wert
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-0 (eingeführt in Windows 8)