GraphicsPath::AddClosedCurve(constPointF*,INT,REAL) metode (gdipluspath.h)

Artikel
09/29/2022

Metode GraphicsPath::AddClosedCurve menambahkan spline kardinal tertutup ke jalur ini.

Sintaks

Status AddClosedCurve(
  [in] const PointF *points,
  [in] INT          count,
  [in] REAL         tension
);

Parameter

[in] points

Jenis: const PointF*

Penunjuk ke array titik yang menentukan spline kardinal. Spline kardinal adalah kurva yang melewati setiap titik dalam array.

[in] count

Jenis: INT

Bilangan bulat yang menentukan jumlah elemen dalam array titik .

[in] tension

Jenis: NYATA

Bilangan riil nonnegatif yang mengontrol panjang kurva dan bagaimana kurva membungkuk. Nilai 0 menentukan bahwa spline adalah urutan segmen garis lurus. Saat nilai meningkat, kurva menjadi lebih penuh.

Mengembalikan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Anda harus menyimpan salinan array titik jika titik tersebut akan diperlukan nanti. Objek GraphicsPath tidak menyimpan titik yang diteruskan ke metode GraphicsPath::AddClosedCurve ; sebaliknya, ia mengubah spline kardinal menjadi urutan spline Bézier dan menyimpan titik-titik yang mendefinisikan spline Bézier tersebut. Anda tidak dapat mengambil array titik asli dari objek GraphicsPath .

Contoh

Contoh berikut membuat jalur objek GraphicsPath, menambahkan spline kardinal tertutup ke jalur, lalu menggambar jalur. Ketegangan diatur ke 1.0.

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, 1.0f);

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

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdipluspath.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll