GetWindowRgn, fonction (winuser.h)
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 |
|---|---|
|
La région est vide. |
|
La région est un rectangle unique. |
|
La région est plusieurs rectangles. |
|
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