GraphicsPath::Metode kerangka (gdipluspath.h)

Artikel
03/14/2023

Metode GraphicsPath::Outline mengubah dan meratakan jalur ini, lalu mengonversi titik data jalur ini sehingga hanya mewakili kerangka jalur.

Sintaks

Status Outline(
  [in] const Matrix *matrix,
  [in] REAL         flatness
);

Parameter

[in] matrix

Jenis: const Matrix*

Pilihan. Penunjuk ke objek Matriks yang menentukan transformasi. Jika parameter ini NULL, tidak ada transformasi yang diterapkan. Nilai defaultnya adalah NULL.

[in] flatness

Jenis: REAL

Opsional. Angka riil yang menentukan kesalahan maksimum antara jalur dan perkiraannya yang diratakan. Mengurangi kerataan meningkatkan jumlah segmen garis dalam perkiraan. Nilai defaultnya adalah FlatnessDefault, yang merupakan konstanta yang ditentukan dalam Gdiplusenums.h.

Nilai kembali

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

Objek GraphicsPath menyimpan kumpulan titik data yang mewakili garis dan kurva. Metode GraphicsPath::Outline mengubah titik data tersebut, dan titik data asli hilang.

Contoh

Contoh berikut membuat objek GraphicsPath dan memanggil metode GraphicsPath::AddClosedCurve untuk menambahkan spline kardinal tertutup ke jalur. Kode memanggil metode GraphicsPath::Widen untuk melebarkan jalur lalu menggambar jalur. Selanjutnya, kode memanggil metode Kerangka jalur. Kode memanggil metode TranslateTransform dari objek Grafis sehingga jalur yang diuraikan yang digambar oleh panggilan berikutnya ke DrawPath berada di sebelah kanan jalur pertama.


VOID OutlineExample(HDC hdc)
{
   Graphics graphics(hdc);

   Pen bluePen(Color(255, 0, 0, 255));
   Pen greenPen(Color(255, 0, 255,  0), 10);

   PointF points[] = {
      PointF(20.0f, 20.0f),
      PointF(160.0f, 100.0f),
      PointF(140.0f, 60.0f),
      PointF(60.0f, 100.0f)};

   GraphicsPath path;
   path.AddClosedCurve(points, 4);

   path.Widen(&greenPen);
   graphics.DrawPath(&bluePen, &path);

   path.Outline();

   graphics.TranslateTransform(180.0f, 0.0f);
   graphics.DrawPath(&bluePen, &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