AddCircleAnnotation

Anotasi dan tautan area interaktif

Deskripsi

Menambahkan ellipse markup annotation (PDF /Subtype /Circle) yang tertulis di dalam rectangle yang diberikan. Meski namanya begitu, anotasinya adalah elips penuh dan hanya merender sebagai lingkaran sungguhan saat Width sama dengan Height. Anotasi 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.AddCircleAnnotation(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 pembatas, dalam satuan saat ini

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

Width — Lebar rectangle pembatas

Height — Tinggi rectangle pembatas

BorderWidth — Lebar stroke border ellipse, 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 ellipse 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 /Circle, /Rect, /C, /IC (saat Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Ini cocok dengan yang dihasilkan Adobe Acrobat dan Foxit untuk tool review ellipse mereka, sehingga workflow review eksternal bisa menemukan, mengedit, mengomentari, dan membalas anotasi hasilnya

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