Метод Region::GetBounds(RectF*,constGraphics*) (gdiplusheaders.h)

Метод Region::GetBounds получает прямоугольник, который заключает эту область.

Синтаксис

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

Параметры

[out] rect

Тип: RectF*

Указатель на объект RectF , который получает включающее прямоугольник.

[in] g

Тип: const Graphics*

Указатель на графический объект, содержащий преобразования мира и страницы, необходимые для вычисления координат устройства этой области и прямоугольника.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Комментарии

Преобразования текущего мира и страниц графического объекта используются для вычисления области и прямоугольника по мере их рисования на устройстве отображения. Прямоугольник, возвращаемый параметром Region::GetBounds , не всегда является наименьшим из возможных прямоугольников.

Примеры

В следующем примере создается область на основе пути, возвращается включающий прямоугольник области, а затем отображается и то, и другое.

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);
}

Требования

Требование Значение
Минимальная версия клиента Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header gdiplusheaders.h (включая Gdiplus.h)
Библиотека Gdiplus.lib
DLL Gdiplus.dll

См. также раздел

GraphicsPath

Регион