Метод PathGradientBrush::GetCenterPoint(Point*) (gdipluspath.h)

Статья
02/29/2024

Метод PathGradientBrush::GetCenterPoint получает центральную точку этой кисти градиента пути.

Синтаксис

Status GetCenterPoint(
  [out] Point *point
);

Параметры

[out] point

Тип: Point*

Указатель на объект Point , который получает центральную точку.

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

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

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

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

По умолчанию центральная точка объекта PathGradientBrush находится в центроиде пути границы кисти, но вы можете задать центральную точку в любом расположении внутри или вне пути, вызвав метод SetCenterPoint объекта PathGradientBrush .

Примеры

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

VOID Example_GetCenterPoint(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to blue.
   pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));

   // Set the color along the entire boundary of the path to aqua.
   Color colors[] = {Color(255, 0, 255, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   // Fill the ellipse with the path gradient brush.
   graphics.FillEllipse(&pthGrBrush, 0, 0, 200, 100);

   // Obtain information about the path gradient brush.
   Point  centerPoint;
   pthGrBrush.GetCenterPoint(&centerPoint);

   // Draw a line from the origin to the center of the ellipse.
   Pen pen(Color(255, 0, 255, 0));
   graphics.DrawLine(&pen, Point(0, 0), centerPoint);
}

Требования

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