AddSquareAnnotation

Anotasi dan tautan area interaktif

Deskripsi

Menambahkan rectangular markup annotation (PDF /Subtype /Square) ke halaman terpilih. Anotasi menggambar rectangle ber-stroke yang tertulis di dalam rectangle pembatas yang diberikan dan 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). 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.8

Sintaks

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: 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

BorderWidth — Lebar stroke border rectangle, dalam satuan saat ini. Ditulis ke field legacy /Border sekaligus dictionary border-style /BS

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

Filled — 1 untuk menuliskan warna isian interior (/IC), 0 untuk membiarkan rectangle 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 atau anotasi gagal dibuat

Catatan

Anotasi dikeluarkan dengan set field markup standar: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (saat Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Ini cocok dengan yang dihasilkan Adobe Acrobat dan Foxit untuk tool review rectangle mereka, sehingga workflow review eksternal bisa menemukan, mengedit, mengomentari, dan membalas anotasi hasilnya

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