GetRandomRgn, fonction (wingdi.h)

Article
03/06/2024

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