Метод LinearGradientBrush::GetRectangle(Rect*) (gdiplusbrush.h)

Статья
08/23/2023

Метод LinearGradientBrush::GetRectangle получает прямоугольник, определяющий границы градиента.

Синтаксис

Status GetRectangle(
  [out] Rect *rect
);

Параметры

[out] rect

Тип: Rect*

Указатель на объект Rect , который получает прямоугольник, определяющий границы градиента. Например, если кисть линейного градиента создается с начальной точкой (20, 50) и конечной точкой в (60, 110), то определяющий прямоугольник имеет верхнюю левую точку в (20, 50), ширину 40 и высоту 60.

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

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

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

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

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

Примеры

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

VOID Example_GetRect(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

Требования


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