AddLineAnnotation

Anotasi dan tautan area interaktif

Deskripsi

Menambahkan line markup annotation (PDF /Subtype /Line) di antara dua endpoint di halaman terpilih. Setiap ujung bisa membawa gaya ujung garis berbeda (panah, persegi, lingkaran, belah ketupat, …) dan badan garis bisa digambar dalam warna RGB apa pun dengan opacity yang bisa diatur. Dekorasi ujung yang punya interior (ClosedArrow, Square, Circle, Diamond) opsional bisa diisi. Karena entry point ini mengeluarkan key opacity /CA anotasi PDF 1.4, library menaikkan dokumen yang lebih rendah dan tidak terkunci ke PDF 1.4 sebelum menyimpan; target yang lebih rendah dan terkunci ditolak oleh compatibility gate. Didefinisikan di ISO 32000-1 §12.5.6.7

Sintaks

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parameter

StartLeft, StartTop — Koordinat titik awal garis, dalam satuan saat ini

EndLeft, EndTop — Koordinat titik akhir garis, dalam satuan saat ini

BorderWidth — Lebar stroke garis 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 endpoint awal dan akhir. 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 atau anotasi gagal dibuat

Catatan

/Rect anotasi dihitung otomatis dari dua endpoint plus padding proporsional terhadap lebar border agar dekorasi ujung tetap di dalam bounding box anotasi. PDF reader mensyaratkan /Rect pembatas memuat seluruh gambaran yang terlihat, atau dekorasi ujung bisa terpotong

Field lanjutan opsional yang dideskripsikan spesifikasi PDF — /LL (leader length), /LLE, /LLO, /Cap, /CP, /CO, 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