AddPolyLineAnnotation

Anotasi dan tautan area interaktif

Deskripsi

Menambahkan polyline markup annotation terbuka (PDF /Subtype /PolyLine) ke halaman terpilih dengan daftar vertex yang diberikan. Polyline-nya terbuka — reader tidak menghubungkan vertex terakhir kembali ke yang pertama — dan bisa membawa gaya ujung garis berbeda di setiap endpoint terminalnya. Dekorasi ujung yang punya interior (ClosedArrow, Square, Circle, Diamond) opsional bisa diisi. Komponen warna dan opacity dinyatakan pada skala 0–1; Transparency diberikan pada skala 0–100 (0 = sepenuhnya opak, 100 = sepenuhnya transparan). Library menaikkan versi dokumen ke PDF 1.5 saat PolyLine annotation dikeluarkan di bawah kunci versi-minimum yang lebih rendah. Didefinisikan di ISO 32000-1 §12.5.6.9

Sintaks

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parameter

VertexCoords — Koordinat vertex sebagai satu string nilai x/y bergantian yang dipisah spasi, koma, titik koma, atau tab. Contoh: "100 100 200 150 300 100" mendefinisikan bentuk V. Membutuhkan minimal dua pasangan (empat angka) dan total angka berjumlah genap, jika tidak panggilan mengembalikan 0

BorderWidth — Lebar stroke polyline beserta dekorasi ujungnya, dalam satuan saat ini

LineRed, LineGreen, LineBlue — Komponen RGB (0–1) dari warna garis, ditulis ke /C

StartStyle, EndStyle — Gaya ujung garis untuk vertex pertama dan terakhir. Gunakan salah satu dari:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

Nilai di luar rentang dibatasi ke 0 (None)

Filled — 1 untuk menuliskan warna isian interior (/IC) bagi dekorasi ujung, 0 untuk membiarkannya tanpa isian

FillRed, FillGreen, FillBlue — Komponen RGB (0–1) dari warna isian interior dekorasi ujung. Diabaikan saat Filled bernilai 0

Title — Nama penulis yang ditulis ke entri /T anotasi. Berikan string kosong untuk melewatinya

Contents — Isi popup yang terkait dengan anotasi. Berikan string kosong untuk melewatinya

Transparency — Opacity yang dinyatakan sebagai persentase transparan (0–100). Library mengonversinya menjadi PDF /CA = 1 - Transparency/100 dan membatasinya ke rentang yang valid

Nilai Kembalian

1 jika sukses, 0 jika tidak ada dokumen terpilih, string vertex gagal di-parse, atau anotasi gagal dibuat

Catatan

/Rect anotasi dihitung otomatis dari luasan vertex plus padding proporsional terhadap lebar border agar dekorasi ujung tetap di dalam bounding box anotasi

Field lanjutan opsional yang dideskripsikan spesifikasi PDF — /IT (intent, termasuk PolyLineDimension) dan /Measure — tidak dikeluarkan entry point ini. Ia bisa ditambahkan setelah dibuat dengan menulisnya langsung ke dictionary anotasi

Untuk meng-overwrite warna garis, border, isi, atau rectangle setelah dibuat, gunakan SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents, dan SetAnnotRect