Método Region::GetHRGN (gdiplusheaders.h)

Artículo
02/29/2024

El método Region::GetHRGN crea una región de interfaz de dispositivo gráfico (GDI) de Windows a partir de esta región.

Sintaxis

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

Parámetros

[in] g

Tipo: gráficos* const

Puntero a un objeto Graphics que contiene las transformaciones de página y mundo necesarias para calcular las coordenadas del dispositivo de esta región.

Valor devuelto

Tipo: HRGN

Este método devuelve un identificador de Windows a una región GDI que se crea a partir de esta región.

Comentarios

Es responsabilidad del autor de la llamada llamar a la función GDI DeleteObject para liberar la región GDI cuando ya no sea necesario.

Ejemplos

En el ejemplo siguiente se crea una región de GDI+ a partir de una ruta de acceso y, a continuación, se usa la región de GDI+ para crear una región de GDI. A continuación, el código usa una función GDI para mostrar la región 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);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll