AddPolygonAnnotation

Anotasi dan tautan area interaktif

Deskripsi

Menambahkan polygon markup annotation tertutup (PDF /Subtype /Polygon) ke halaman terpilih dengan daftar vertex yang diberikan. Polygon secara implisit tertutup — reader menghubungkan vertex terakhir kembali ke yang pertama saat merender. Bentuknya opsional bisa diisi warna interior solid. 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 Polygon annotation dikeluarkan di bawah kunci versi-minimum yang lebih rendah. Didefinisikan di ISO 32000-1 §12.5.6.9

Sintaks

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; 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 100 200 200 100 200" mendefinisikan persegi. Membutuhkan minimal dua pasangan (empat angka) dan total angka berjumlah genap, jika tidak panggilan mengembalikan 0

BorderWidth — Lebar stroke outline polygon, dalam satuan saat ini

BorderRed, BorderGreen, BorderBlue — Komponen RGB (0–1) dari warna outline, ditulis ke /C

Filled — 1 untuk menuliskan warna isian interior (/IC) untuk badan polygon, 0 untuk membiarkannya tanpa isian

FillRed, FillGreen, FillBlue — Komponen RGB (0–1) dari warna isian interior. 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 kecil proporsional terhadap lebar border agar stroke outline tetap di dalam bounding box anotasi

Field lanjutan opsional yang dideskripsikan spesifikasi PDF — /BE (border effect, termasuk gaya outline cloudy), /IT (intent, termasuk PolygonCloud dan PolygonDimension), dan /Measure — tidak dikeluarkan entry point ini. Ia bisa ditambahkan setelah dibuat dengan menulisnya langsung ke dictionary anotasi

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