GetClipRgn, fonction (wingdi.h)
La fonction GetClipRgn récupère un handle identifiant la région de découpage définie par l’application actuelle pour le contexte d’appareil spécifié.
Syntaxe
int GetClipRgn(
[in] HDC hdc,
[in] HRGN hrgn
);
Paramètres
[in] hdc
Handle dans le contexte de l’appareil.
[in] hrgn
Handle vers une région existante avant l’appel de la fonction. Une fois la fonction retournée, ce paramètre est un handle vers une copie de la région de découpage actuelle.
Valeur retournée
Si la fonction réussit et qu’il n’y a pas de zone de découpage pour le contexte d’appareil donné, la valeur de retour est zéro. Si la fonction réussit et qu’il existe une zone de découpage pour le contexte d’appareil donné, la valeur de retour est 1. Si une erreur se produit, la valeur de retour est -1.
Remarques
Une région de découpage définie par l’application est une région de découpage identifiée par la fonction SelectClipRgn . Il ne s’agit pas d’une zone de découpage créée lorsque l’application appelle la fonction BeginPaint .
Si la fonction réussit, le paramètre hrgn est un handle vers une copie de la région de découpage actuelle. Les modifications ultérieures apportées à cette copie n’affecteront pas la région de découpage actuelle.
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 | wingdi.h (inclure Windows.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |