Funzione AdjustWindowRectEx (winuser.h)

Articolo
08/27/2023

Calcola le dimensioni necessarie del rettangolo della finestra, in base alle dimensioni desiderate del rettangolo client. Il rettangolo della finestra può quindi essere passato alla funzione CreateWindowEx per creare una finestra la cui area client è la dimensione desiderata.

Sintassi

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

Parametri

[in, out] lpRect

Tipo: LPRECT

Puntatore a una struttura RECT che contiene le coordinate degli angoli superiore sinistro e inferiore destro dell'area client desiderata. Quando la funzione viene restituita, la struttura contiene le coordinate degli angoli superiore sinistro e inferiore destro della finestra per ospitare l'area client desiderata.

[in] dwStyle

Tipo: DWORD

Stile della finestra la cui dimensione necessaria deve essere calcolata. Si noti che non è possibile specificare lo stile di WS_OVERLAPPED .

[in] bMenu

Tipo: BOOL

Indica se la finestra include un menu.

[in] dwExStyle

Tipo: DWORD

Stile della finestra estesa la cui dimensione necessaria deve essere calcolata.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Un rettangolo client è il rettangolo più piccolo che racchiude completamente un'area client. Un rettangolo di finestra è il rettangolo più piccolo che racchiude completamente la finestra, che include l'area client e l'area non client.

La funzione AdjustWindowRectEx non aggiunge spazio aggiuntivo quando una barra dei menu viene disposta su due o più righe.

La funzione AdjustWindowRectEx non tiene conto degli stili WS_VSCROLL o WS_HSCROLL . Per tenere conto delle barre di scorrimento, chiamare la funzione GetSystemMetrics con SM_CXVSCROLL o SM_CYHSCROLL.

Questa API non riconosce i valori DPI e non deve essere usata se il thread chiamante è compatibile con DPI per monitor. Per la versione compatibile con DPI di questa API, vedere AdjustWindowsRectExForDPI. Per altre informazioni sulla consapevolezza dpi, vedere la documentazione di Windows High DPI.For more information on DPI awareness, see the Windows High DPI documentation.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8)