Método Region::GetBounds(RectF*,constGraphics*) (gdiplusheaders.h)

O método Region::GetBounds obtém um retângulo que inclui essa região.

Sintaxe

Status GetBounds(
  [out] RectF          *rect,
  [in]  const Graphics *g
);

Parâmetros

[out] rect

Tipo: RectF*

Ponteiro para um objeto RectF que recebe o retângulo delimitador.

[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 e do retângulo.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

O mundo atual e as transformações de página do objeto gráfico são usados para calcular a região e o retângulo conforme são desenhados no dispositivo de exibição. O retângulo retornado por Region::GetBounds nem sempre é o menor retângulo possível.

Exemplos

O exemplo a seguir cria uma região de um caminho, obtém o retângulo delimitador da região e exibe ambos.

VOID Example_GetBoundsRectF(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;
    SolidBrush solidBrush(Color(255, 255, 0, 0));
    Pen pen(Color(255, 0, 0, 0));
    RectF rect;

   path.AddClosedCurve(points, 6);

    // Create a region from a path.
    Region pathRegion(&path);
    
    // Get the region's enclosing rectangle.
    pathRegion.GetBounds(&rect, &graphics);

    // Show the region and the enclosing rectangle.
    graphics.FillRegion(&solidBrush, &pathRegion);
    graphics.DrawRectangle(&pen, rect);
}

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

Graphicspath

Região