Метод PathGradientBrush::GetRectangle(RectF*) (gdipluspath.h)

Статья
07/16/2024

Метод PathGradientBrush::GetRectangle получает наименьший прямоугольник, который заключает путь границ этой кисти градиента пути.

Синтаксис

Status GetRectangle(
  RectF *rect
);

Параметры

rect

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

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

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

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

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

Замечания

Примеры

В следующем примере создается объект PathGradientBrush на основе многоугольника, определенного четырьмя точками. Код вызывает метод PathGradientBrush::GetRectangle объекта PathGradientBrush, чтобы получить наименьший прямоугольник, который заключает путь границ кисти. Код вызывает метод Graphics::FillRectangle объекта Graphics, передав адрес объекта PathGradientBrush и ссылку на ограничивающий прямоугольник кисти. Этот вызов заполняет только часть ограничивающего прямоугольника, который находится внутри пути границы кисти. Наконец, код рисует контур ограничивающего прямоугольника.

VOID Example_GetRect(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 0));

   // Create a path gradient brush based on an array of points.
   Point points[] = {
      Point(30, 20),
      Point(150, 40),
      Point(100, 100),
      Point(60, 200) };

   PathGradientBrush pthGrBrush(points, 4);

   // Obtain information about the path gradient brush.
   RectF rect;
   pthGrBrush.GetRectangle(&rect);

   graphics.FillRectangle(&pthGrBrush, rect);
   graphics.DrawRectangle(&pen, rect);
}