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

Статья
07/16/2024

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

Синтаксис

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

Параметры

points

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

count

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

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

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

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

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

Замечания

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

Примеры

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

VOID Example_AddClosedCurve(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.AddClosedCurve(pts, 4);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}