Fonction AdjustWindowRect (winuser.h)

Article
08/27/2023

Calcule la taille requise du rectangle de fenêtre, en fonction de la taille de rectangle client souhaitée. Le rectangle de fenêtre peut ensuite être passé à la fonction CreateWindow pour créer une fenêtre dont la zone cliente correspond à la taille souhaitée.

Pour spécifier un style de fenêtre étendu, utilisez la fonction AdjustWindowRectEx .

Syntaxe

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

Paramètres

[in, out] lpRect

Type : LPRECT

Pointeur vers une structure RECT qui contient les coordonnées des coins supérieur gauche et inférieur droit de la zone cliente souhaitée. Lorsque la fonction retourne, la structure contient les coordonnées des coins supérieur gauche et inférieur droit de la fenêtre pour prendre en charge la zone cliente souhaitée.

[in] dwStyle

Type : DWORD

Style de fenêtre de la fenêtre dont la taille requise doit être calculée. Notez que vous ne pouvez pas spécifier le style WS_OVERLAPPED .

[in] bMenu

Type : BOOL

Indique si la fenêtre a un menu.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Un rectangle client est le plus petit rectangle qui entoure complètement une zone cliente. Un rectangle de fenêtre est le plus petit rectangle qui entoure complètement la fenêtre, ce qui inclut la zone cliente et la zone non cliente.

La fonction AdjustWindowRect n’ajoute pas d’espace supplémentaire lorsqu’une barre de menus est encapsulé à deux lignes ou plus.

La fonction AdjustWindowRect ne prend pas en compte les styles WS_VSCROLL ou WS_HSCROLL . Pour tenir compte des barres de défilement, appelez la fonction GetSystemMetrics avec SM_CXVSCROLL ou SM_CYHSCROLL.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-4 (introduit dans Windows 10, version 10.0.14393)