GraphicsPath::Metode GetPathData (gdipluspath.h)

Artikel
02/26/2024

Metode GraphicsPath::GetPathData mendapatkan array titik dan array jenis titik dari jalur ini. Bersama-sama, kedua array ini mendefinisikan garis, kurva, gambar, dan penanda jalur ini.

Sintaks

Status GetPathData(
  [out] PathData *pathData
);

Parameter

[out] pathData

Jenis: PathData*

Penunjuk ke objek PathData yang menerima data jalur. Anggota data Points dari objek PathData menerima pointer ke array objek PointF yang berisi titik jalur. Anggota data Jenis objek PathData menerima penunjuk ke array byte yang berisi jenis titik. Anggota data Count dari objek PathData menerima bilangan bulat yang menunjukkan jumlah elemen dalam array Points .

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 memiliki array titik dan array jenis. Setiap elemen dalam array jenis adalah byte yang menentukan jenis titik dan sekumpulan bendera untuk elemen yang sesuai dalam array titik. Kemungkinan jenis titik dan bendera tercantum dalam enumerasi PathPointType .

Anda tidak perlu mengalokasikan atau membatalkan alokasi memori untuk array titik atau array jenis. Metode GraphicsPath::GetPathData mengalokasikan memori untuk array (titik dan jenis) yang dikembalikannya. Destruktor PathData membatalkan alokasi memori untuk array tersebut.

Contoh

Contoh berikut membuat dan menggambar jalur yang memiliki garis, persegi panjang, elips, dan kurva. Kode mendapatkan titik dan jenis jalur dengan meneruskan alamat objek PathData ke metode GraphicsPath::GetPathData . Kemudian kode menggambar masing-masing titik data jalur.

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

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;
   
   PointF points[] = {
      PointF(200, 200),
      PointF(250, 240),
      PointF(200, 300),
      PointF(300, 310),
      PointF(250, 350)};

   path.AddLine(20, 100, 150, 200);
   path.AddRectangle(Rect(40, 30, 80, 60));
   path.AddEllipse(Rect(200, 30, 200, 100));
   path.AddCurve(points, 5);

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

   // Get the path data.
   PathData pathData;
   path.GetPathData(&pathData);

   // Draw the path's data points.
   SolidBrush brush(Color(255, 255, 0, 0));
   for(INT j = 0; j < pathData.Count; ++j)
   {
      graphics.FillEllipse(
         &brush, 
         pathData.Points[j].X - 3.0f, 
         pathData.Points[j].Y - 3.0f,
         6.0f,
         6.0f);
   }
}

Persyaratan

Persyaratan	Nilai
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