Region ::GetHRGN, méthode (gdiplusheaders.h)

Article
02/26/2024

La méthode Region ::GetHRGN crée une région GDI (Windows Graphics Device Interface) à partir de cette région.

Syntaxe

HRGN GetHRGN(
  [in] const Graphics *g
);

Paramètres

[in] g

Type : const Graphics*

Pointeur vers un objet Graphics qui contient les transformations de monde et de page nécessaires pour calculer les coordonnées d’appareil de cette région.

Valeur retournée

Type : HRGN

Cette méthode retourne un handle Windows à une région GDI créée à partir de cette région.

Remarques

Il incombe à l’appelant d’appeler la fonction GDI DeleteObject pour libérer la région GDI quand elle n’est plus nécessaire.

Exemples

L’exemple suivant crée une région GDI+ à partir d’un chemin d’accès, puis utilise la région GDI+ pour créer une région GDI. Le code utilise ensuite une fonction GDI pour afficher la région GDI.

VOID Example_GetHRGN(HDC hdc)
{
   Graphics graphics(hdc);

    Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   GraphicsPath path;
   path.AddClosedCurve(points, 6);

    // Create a region from a path.
    Region pathRegion(&path);

   // Get a handle to a GDI region.
   HRGN hRegion;
   hRegion = pathRegion.GetHRGN(&graphics);

   // Use GDI to display the region.
   HBRUSH hBrush = CreateSolidBrush(RGB(255, 0, 0));
   FillRgn(hdc, hRegion, hBrush);

   DeleteObject(hBrush);
   DeleteObject(hRegion);
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, 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	gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll