Fungsi GetPath (wingdi.h)

Artikel
03/08/2023

Fungsi GetPath mengambil koordinat yang menentukan titik akhir garis dan titik kontrol kurva yang ditemukan di jalur yang dipilih ke dalam konteks perangkat yang ditentukan.

Sintaks

int GetPath(
  [in]  HDC     hdc,
  [out] LPPOINT apt,
  [out] LPBYTE  aj,
  [in]  int     cpt
);

Parameter

[in] hdc

Handel ke konteks perangkat yang berisi jalur tertutup.

[out] apt

Penunjuk ke array struktur POINT yang menerima titik akhir garis dan titik kontrol kurva, dalam koordinat logis.

[out] aj

Penunjuk ke array byte yang menerima jenis vertex. Parameter ini bisa menjadi salah satu nilai berikut.

Jenis	Deskripsi
PT_MOVETO	Menentukan bahwa titik yang sesuai dalam parameter lpPoints memulai gambar yang terputar.
PT_LINETO	Menentukan bahwa titik sebelumnya dan titik yang sesuai di lpPoints adalah titik akhir garis.
PT_BEZIERTO	Menentukan bahwa titik yang sesuai dalam lpPoints adalah titik kontrol atau titik akhir untuk kurva Bézier. PT_BEZIERTO nilai selalu terjadi dalam set tiga. Titik di jalur segera mendahuluinya mendefinisikan titik awal untuk kurva Bézier. Dua titik PT_BEZIERTO pertama adalah titik kontrol, dan titik PT_BEZIERTO ketiga adalah titik akhir (jika dikodekan secara permanen).

Nilai PT_LINETO atau PT_BEZIERTO dapat dikombinasikan dengan nilai berikut (dengan menggunakan operator bitwise ATAU) untuk menunjukkan bahwa titik yang sesuai adalah titik terakhir dalam gambar dan gambar harus ditutup.

Bendera	Deskripsi
PT_CLOSEFIGURE	Menentukan bahwa gambar ditutup secara otomatis setelah garis atau kurva yang sesuai digambar. Gambar ditutup dengan menggambar garis dari garis atau titik akhir kurva ke titik yang sesuai dengan PT_MOVETO terakhir.

[in] cpt

Jumlah total struktur POINT yang dapat disimpan dalam array yang ditujukkan oleh lpPoints. Nilai ini harus sama dengan jumlah byte yang dapat ditempatkan dalam array yang ditujukkan oleh lpTypes.

Mengembalikan nilai

Jika parameter nSize bukan nol, nilai yang dikembalikan adalah jumlah titik yang dijumlahkan. Jika nSize adalah 0, nilai yang dikembalikan adalah jumlah total titik dalam jalur (dan GetPath tidak menulis apa pun ke buffer). Jika nSize bukan nol dan kurang dari jumlah titik dalam jalur, nilai yang dikembalikan adalah 1.

Keterangan

Konteks perangkat yang diidentifikasi oleh parameter hdc harus berisi jalur tertutup.

Titik-titik jalur dikembalikan dalam koordinat logis. Titik disimpan di jalur dalam koordinat perangkat, sehingga GetPath mengubah titik dari koordinat perangkat menjadi koordinat logis dengan menggunakan inversi transformasi saat ini.

Fungsi FlattenPath dapat dipanggil sebelum GetPath untuk mengonversi semua kurva di jalur menjadi segmen garis.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll