AddCaretAnnotation

Anotasi dan tautan area interaktif

Deskripsi

Menambahkan caret markup annotation (PDF /Subtype /Caret) ke halaman terpilih. Caret annotation adalah simbol visual yang lazim menandai posisi di halaman tempat teks atau konten disisipkan, dihilangkan, atau membutuhkan perhatian reviewer. Dua bentuk simbol tersedia: caret polos (None) atau tanda paragraf (Paragraph). 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 Caret annotation dikeluarkan di bawah kunci versi-minimum yang lebih rendah. Didefinisikan di ISO 32000-1 §12.5.6.11

Sintaks

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parameter

Left — Koordinat horizontal pojok kiri bawah rectangle anotasi, dalam satuan saat ini

Top — Koordinat vertikal pojok kiri bawah rectangle anotasi, dalam satuan saat ini

Width — Lebar rectangle anotasi

Height — Tinggi rectangle anotasi

SymbolType — Caret symbol style:

0 = None (plain caret "^")

1 = Paragraph (pilcrow "¶")

Nilai lain diperlakukan 0 (None)

ColorRed, ColorGreen, ColorBlue — Komponen RGB (0–1) dari warna caret, ditulis ke /C

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

Anotasi dikeluarkan dengan /Type /Annot, /Subtype /Caret, /Rect, /Sy (nama simbol), /C, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret", dan /P. Field opsional /RD (offset caret di dalam /Rect) tidak dikeluarkan; reader menganggapnya nol semua sehingga caret menempati rectangle anotasi penuh

Untuk menimpa persegi panjang, warna, atau isi anotasi setelah dibuat, gunakan SetAnnotRect, SetAnnotBorderColor, dan SetAnnotContents.