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

El método Region::GetBounds obtiene un rectángulo que incluye esta región.

Sintaxis

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

Parámetros

[out] rect

Tipo: RectF*

Puntero a un objeto RectF que recibe el rectángulo envolvente.

[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 y el rectángulo.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Las transformaciones de página y mundo actuales del objeto gráfico se usan para calcular la región y el rectángulo a medida que se dibujan en el dispositivo de visualización. El rectángulo devuelto por Region::GetBounds no siempre es el rectángulo más pequeño posible.

Ejemplos

En el ejemplo siguiente se crea una región a partir de una ruta de acceso, se obtiene el rectángulo envolvente de la región y, a continuación, se muestran 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	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

Consulte también

Graphicspath

Región