AdjustWindowRectExForDpi-Funktion (winuser.h)

Artikel
03/13/2024

Berechnet die erforderliche Größe des Fensterrechtecks basierend auf der gewünschten Größe des Clientrechtecks und dem angegebenen DPI-Wert. Dieses Fensterrechteck kann dann an die CreateWindowEx-Funktion übergeben werden, um ein Fenster mit einem Clientbereich der gewünschten Größe zu erstellen.

Syntax

BOOL AdjustWindowRectExForDpi(
  [in, out] LPRECT lpRect,
  [in]      DWORD  dwStyle,
  [in]      BOOL   bMenu,
  [in]      DWORD  dwExStyle,
  [in]      UINT   dpi
);

Parameter

[in, out] 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

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

[in] bMenu

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

[in] dwExStyle

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

[in] dpi

Der DPI-Wert, der für die Skalierung verwendet werden soll.

Rückgabewert

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

Diese Funktion gibt das gleiche Ergebnis wie AdjustWindowRectEx zurück, skaliert es jedoch entsprechend einem beliebigen DPI-Wert, den Sie ggf. angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll

Share via