AdjustWindowRectEx, fonction (winuser.h)

Article
03/04/2024

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

Syntaxe

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

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.

[in] dwExStyle

Type : DWORD

Style de fenêtre étendu de la fenêtre dont la taille requise doit être calculée.

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 AdjustWindowRectEx n’ajoute pas d’espace supplémentaire lorsqu’une barre de menus est encapsulé à deux lignes ou plus.

La fonction AdjustWindowRectEx 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.

Cette API n’est pas compatible avec DPI et ne doit pas être utilisée si le thread appelant prend en charge le DPI par moniteur. Pour obtenir la version prenant en charge DPI de cette API, consultez AjusterWindowsRectExForDPI. Pour plus d’informations sur la sensibilisation aux PPP, consultez la documentation Windows High DPI.

Configuration requise

Condition requise	Valeur
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-0 (introduit dans Windows 8)