GetRandomRgn, fonction (wingdi.h)
La fonction GetRandomRgn copie la région de découpage système d’un contexte d’appareil spécifié dans une région spécifique.
Syntaxe
int GetRandomRgn(
[in] HDC hdc,
[in] HRGN hrgn,
[in] INT i
);
Paramètres
[in] hdc
Handle dans le contexte de l’appareil.
[in] hrgn
Handle vers une région. Avant l’appel de la fonction, cela identifie une région existante. Une fois la fonction retournée, elle identifie une copie de la région système actuelle. L’ancienne région identifiée par hrgn est remplacée.
[in] i
Ce paramètre doit être SYSRGN.
Valeur retournée
Si la fonction réussit, la valeur de retour est 1. Si la fonction échoue, la valeur de retour est -1. Si la région à récupérer est NULL, la valeur de retour est 0. Si la fonction échoue ou si la région à récupérer est NULL, hrgn n’est pas initialisé.
Remarques
Lorsque vous utilisez l’indicateur SYSRGN, notez que la région de découpage du système peut ne pas être actuelle en raison des mouvements de fenêtre. Néanmoins, il est sûr de récupérer et d’utiliser la région de découpage système dans le bloc BeginPaint-EndPaint pendant WM_PAINT traitement. Dans ce cas, la région système est l’intersection de la région de mise à jour et de la zone visible actuelle de la fenêtre. Tout mouvement de fenêtre suivant le retour de GetRandomRgn et avant EndPaint entraîne un nouveau message WM_PAINT . Toute autre utilisation de l’indicateur SYSRGN peut entraîner des erreurs de peinture dans votre application.
La région retournée est dans les coordonnées d’écran.
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 |