Funzione AdjustWindowRect (winuser.h)

Articolo
08/27/2023

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

Per specificare uno stile di finestra esteso, usare la funzione AdjustWindowRectEx .

Sintassi

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

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 restituisce, la struttura contiene le coordinate degli angoli superiore sinistro e inferiore destro della finestra per supportare l'area client desiderata.

[in] dwStyle

Tipo: DWORD

Stile finestra della finestra le cui dimensioni necessarie devono essere calcolate. Si noti che non è possibile specificare lo stile di WS_OVERLAPPED .

[in] bMenu

Tipo: BOOL

Indica se la finestra ha un menu.

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 nonclient.

La funzione AdjustWindowRect non aggiunge spazio aggiuntivo quando una barra dei menu esegue il wrapping di due o più righe.

La funzione AdjustWindowRect 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.

Requisiti


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-4 (introdotta in Windows 10, versione 10.0.14393)