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

Статья
08/24/2023

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

Синтаксис

Status AddCurve(
  [in] const Point *points,
  [in] INT         count,
  [in] REAL        tension
);

Параметры

[in] points

Тип: const Point*

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

[in] count

Тип: INT

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

[in] tension

Тип: REAL

Неизрицательное вещественное число, определяющее длину кривой и способ ее изгиба. Значение 0 указывает, что сплайн является последовательностью сегментов прямой линии. По мере увеличения значения кривая становится более полной.

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

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

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

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

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

Примеры

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

VOID AddCurveExample(HDC hdc)
{
   Graphics graphics(hdc);
   Point pts[] = {Point(50, 50),
                  Point(60, 20),
                  Point(70, 100),
                  Point(80, 50)};
   GraphicsPath path;
   path.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);   
}
Color(255, 255, 0,  0)

Требования

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