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

Статья
07/16/2024

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

Синтаксис

Status GetCenterPoint(
  PointF *point
);

Параметры

point

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

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

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

Если метод выполнен успешно, он возвращает ok, который является элементом перечисления 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.
   PointF 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, PointF(0, 0), centerPoint);  
}