GetWindowRgnBox, fonction (winuser.h)

Article
03/06/2024

La fonction GetWindowRgnBox récupère les dimensions du rectangle englobant le plus étroit pour la région de fenêtre d’une fenêtre.

Syntaxe

int GetWindowRgnBox(
  [in]  HWND   hWnd,
  [out] LPRECT lprc
);

Paramètres

[in] hWnd

Handle vers la fenêtre.

[out] lprc

Pointeur vers une structure RECT qui reçoit les dimensions du rectangle, en unités d’appareil par rapport au coin supérieur gauche de la fenêtre.

Valeur retournée

La valeur de retour spécifie le type de la région que la fonction obtient. Il peut avoir l’une des valeurs suivantes.

Valeur	Signification
COMPLEXREGION	La région est plusieurs rectangles.
ERROR	La fenêtre spécifiée n’a pas de région ou une erreur s’est produite lors de la tentative de retour de la région.
NULLREGION	La région est vide.
SIMPLEREGION	La région est un rectangle unique.

Remarques

La région de la fenêtre détermine la zone dans la fenêtre où le système autorise le dessin. Le système n’affiche aucune partie d’une fenêtre située en dehors de la région de la fenêtre. Les coordonnées de la région de fenêtre d’une fenêtre sont relatives au coin supérieur gauche de la fenêtre, et non à la zone cliente de la fenêtre.

Pour définir la région de fenêtre d’une fenêtre, appelez la fonction SetWindowRgn .

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