Fungsi PolyDraw (wingdi.h)

Artikel
08/15/2024

Fungsi PolyDraw menggambar serangkaian segmen garis dan kurva Bézier.

Sintaksis

BOOL PolyDraw(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const BYTE  *aj,
  [in] int         cpt
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] apt

Penunjuk ke array struktur POINT yang berisi titik akhir untuk setiap segmen garis dan titik akhir dan titik kontrol untuk setiap kurva Bézier, dalam unit logis.

[in] aj

Penunjuk ke array yang menentukan bagaimana setiap titik dalam array lppt digunakan. Parameter ini bisa menjadi salah satu nilai berikut.

Jenis	Arti
PT_MOVETO	Menentukan bahwa titik ini memulai figur yang terputar. Titik ini menjadi posisi baru saat ini.
PT_LINETO	Menentukan bahwa garis akan digambar dari posisi saat ini ke titik ini, yang kemudian menjadi posisi baru saat ini.
PT_BEZIERTO	Menentukan bahwa titik ini adalah titik kontrol atau titik akhir untuk kurva Bézier. PT_BEZIERTO jenis selalu terjadi dalam set tiga. Posisi saat ini mendefinisikan titik awal untuk kurva Bézier. Dua titik PT_BEZIERTO pertama adalah titik kontrol, dan titik PT_BEZIERTO ketiga adalah titik akhir. Titik akhir menjadi posisi baru saat ini. Jika tidak ada tiga poin PT_BEZIERTO berturut-turut, hasil kesalahan.

Jenis 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 ditutup.

Nilai	Arti
PT_CLOSEFIGURE	Menentukan bahwa gambar ditutup secara otomatis setelah jenis PT_LINETO atau PT_BEZIERTO untuk titik ini selesai. Garis digambar dari titik ini ke titik PT_MOVETO terbaru atau MoveToEx point. Nilai ini dikombinasikan dengan jenis PT_LINETO untuk garis, atau dengan jenis PT_BEZIERTO titik akhir untuk kurva Bézier, dengan menggunakan operator bitwise ATAU. Posisi saat ini diatur ke titik akhir baris penutup.

Nilai

Arti

PT_CLOSEFIGURE

Menentukan bahwa gambar ditutup secara otomatis setelah jenis PT_LINETO atau PT_BEZIERTO untuk titik ini selesai. Garis digambar dari titik ini ke titik PT_MOVETO terbaru atau MoveToEx point.

Nilai ini dikombinasikan dengan jenis PT_LINETO untuk garis, atau dengan jenis PT_BEZIERTO titik akhir untuk kurva Bézier, dengan menggunakan operator bitwise ATAU.

Posisi saat ini diatur ke titik akhir baris penutup.

[in] cpt

Jumlah total titik dalam array lppt , sama dengan jumlah byte dalam array lpbTypes .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Fungsi PolyDraw dapat digunakan sebagai pengganti panggilan berturut-turut ke fungsi MoveToEx, LineTo, dan PolyBezierTo untuk menggambar figur yang tidak putus-putus. Garis dan kurva digambar menggunakan pena saat ini dan gambar tidak diisi. Jika ada jalur aktif yang dimulai dengan memanggil BeginPath, PolyDraw menambahkan ke jalur tersebut.

Titik yang terkandung dalam array lppt dan dalam array lpbTypes menunjukkan apakah setiap titik merupakan bagian dariMoveTo , LineTo, , atau polyBezierTo operasi. Dimungkinkan juga untuk menutup angka.

Fungsi ini memperbarui posisi saat ini.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

BeginPath

EndPath

Fungsi Garis dan Kurva

LineTo

Gambaran Umum Garis dan Kurva

MoveToEx

POINT

PolyBezierTo

PolyLine

Bagikan melalui