Partager via


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

Voir aussi

BeginPaint

Fonctions de découpage

Vue d’ensemble de la coupe

EndPaint

ExtSelectClipRgn

GetClipBox

GetClipRgn

GetRegionData

OffsetRgn