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

Статья
07/16/2024

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

Синтаксис

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

Параметры

points

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

count

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

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

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

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

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

Замечания

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

Примеры

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

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);
}