GetWindowRgn, fonction (winuser.h)

  • Article

La fonction GetWindowRgn obtient une copie de la région de fenêtre d’une fenêtre. La région de fenêtre d’une fenêtre est définie en appelant la fonction SetWindowRgn . 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

Syntaxe

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Paramètres

[in] hWnd

Gérez la fenêtre dont la région de fenêtre doit être obtenue.

[in] hRgn

Gérez la région qui sera modifiée pour représenter la région 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.

Code de retour Description
NULLREGION
 La région est vide.
SIMPLEREGION
 La région est un rectangle unique.
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.

Remarques

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 .

Exemples

Le code suivant montre comment passer le handle d’une région existante.


HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

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-draw-l1-1-2 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

SetWindowRgn