GetWindowRect, fonction (winuser.h)

Article
08/27/2023

Récupère les dimensions du rectangle englobant de la fenêtre spécifiée. Les dimensions sont indiquées dans les coordonnées de l’écran qui sont par rapport au coin supérieur gauche de l’écran.

Syntaxe

BOOL GetWindowRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[out] lpRect

Type : LPRECT

Pointeur vers une structure RECT qui reçoit les coordonnées d’écran des coins supérieur gauche et inférieur droit de la fenêtre.

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

Conformément aux conventions de la structure RECT , les coordonnées en bas à droite du rectangle retourné sont exclusives. En d’autres termes, le pixel (à droite, en bas) se trouve immédiatement à l’extérieur du rectangle.

GetWindowRect est virtualisé pour DPI.

Dans Windows Vista et versions ultérieures, la fenêtre Rect inclut désormais la zone occupée par l’ombre portée.

L’appel de GetWindowRect aura un comportement différent selon que la fenêtre a déjà été affichée ou non. Si la fenêtre n’a pas été affichée auparavant, GetWindowRect n’inclut pas la zone de l’ombre portée.

Pour obtenir les limites de fenêtre à l’exclusion de l’ombre portée, utilisez DwmGetWindowAttribute, en spécifiant DWMWA_EXTENDED_FRAME_BOUNDS. Notez que contrairement au rect de la fenêtre, les limites d’images étendues DWM ne sont pas ajustées pour les ppp. L’obtention des limites d’image étendues ne peut être effectuée qu’une fois que la fenêtre a été affichée au moins une fois.

Exemples

Pour obtenir un exemple, consultez Initialisation d’une boîte de dialogue.

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