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

O método Region::GetHRGN cria uma região da GDI (Interface de Dispositivo Gráfico do Windows) dessa região.

Sintaxe

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

Parâmetros

[in] g

Tipo: const Graphics*

Ponteiro para um objeto Graphics que contém o mundo e as transformações de página necessárias para calcular as coordenadas do dispositivo dessa região.

Retornar valor

Tipo: HRGN

Esse método retorna um identificador do Windows para uma região GDI criada a partir dessa região.

Comentários

É responsabilidade do chamador chamar a função GDI DeleteObject para liberar a região GDI quando ela não for mais necessária.

Exemplos

O exemplo a seguir cria uma região GDI+ de um caminho e, em seguida, usa a região GDI+ para criar uma região GDI. Em seguida, o código usa uma função GDI para exibir a região 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	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

DeleteObject

Elementos gráficos

Rect

Região