Метод GraphicsPath::AddCurve(constPointF*,INT) (gdipluspath.h)

Статья
08/24/2023

Метод GraphicsPath::AddCurve добавляет кардинальный сплайн к текущему рисунку этого пути.

Синтаксис

Status AddCurve(
  const PointF *points,
  INT          count
);

Параметры

points

Указатель на массив точек, определяющих кардинальный сплайн. Кардинальный сплайн — это кривая, которая проходит через каждую точку в массиве.

count

Целое число, указывающее количество элементов в массиве точек.

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

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

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

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

Если эти точки понадобятся позже, следует сохранить копию массива точек. Объект GraphicsPath не хранит точки, передаваемые методу AddClosedCurve ; вместо этого он преобразует кардинальный сплайн в последовательность сплайнов Безье и сохраняет точки, определяющие эти сплайны Безье. Невозможно получить исходный массив точек из объекта GraphicsPath.

Примеры

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

VOID AddCurveExample(HDC hdc)
{
   Graphics graphics(hdc);
   PointF pts[] = {PointF(50.0f, 50.0f),
                   PointF(60.0f, 20.0f),
                   PointF(70.0f, 100.0f),
                   PointF(80.0f, 50.0f)};
   GraphicsPath path;
   path.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}