Metode THotPDF.SetLoadedFreeTextText
Mengganti tampilan normal sebuah anotasi FreeText termuat memakai font Unicode tertanam, rich text opsional, dan transaksi graf atomik
Deklarasi
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');
Opsi
Inisialisasi record dengan THPDFLoadedTextAppearanceOptions.Default sebelum mengubah field individual
| Field | Perilaku |
|---|---|
| FontName, FontStyle, FontSize | Font utama, style, dan ukuran poin; defaultnya Arial, regular, dan 12 poin |
| TextColor, Alignment, Padding | Warna teks biasa, perataan kiri/tengah/kanan, dan padding poin; defaultnya hitam, kiri, dan 2 poin |
| Opacity, Rotation | Opacity dalam [0,1] dan rotasi dalam kelipatan 90 derajat |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy: ltopReject menolak overflow, ltopClip memotongnya, dan ltopShrinkToFit mencoba ulang dengan font lebih kecil |
| MinFontSize | Batas bawah pengecilan, default 4 poin |
| MaxTextUnits | Anggaran masukan dan teks biasa, default 1,048,576 unit UTF-16; masukan rich dibatasi empat kali anggaran ini |
Perilaku
AText menyuplai teks Unicode biasa; RichContent UTF-8 yang tidak kosong justru memakai HTML importer dan DefaultStyle CSS opsional, lalu menurunkan /Contents dari teks yang dihasilkan
Tampilan yang dihasilkan menyalin font tertanam dan mapping ToUnicode ke dokumen termuat, sehingga penyimpanan, flattening, dan ekstraksi teks tetap mempertahankan teks Unicode-nya
Metode mewarisi rantai fallback font yang terkonfigurasi, ShapingFeatures, saklar auto-shaping Arab, Suryani, N'Ko, Adlam, dan Hanifi Rohingya, serta pilihan skrip dan bahasa GSUB; setiap percobaan ulang shrink-to-fit memakai pengaturan yang sama tanpa mengubah konfigurasi pemanggil
Metode ini mempertahankan latar belakang yang didukung, bingkai solid/putus-putus, inset persegi panjang, dan geometri callout dua/tiga titik, serta menyinkronkan /AP, /Contents, /RC, /DS, /CA, /Q, dan metadata rotasi
Geometri tidak valid, glyph teks biasa yang tak terpecahkan, bingkai cloudy, batas resource, dan overflow yang ditolak memunculkan exception dan melakukan rollback seluruh pembaruan; transaksi graf terluar yang sudah ada tetap aktif
Rich text mengikuti subset HTML/CSS yang didukung; resource eksternal dinonaktifkan dan ukuran font CSS yang tetap bisa menghalangi shrink-to-fit mengecilkan run individual
Setiap penulis tampilan menerima paling banyak 256 pilihan font shaping yang berbeda dan 64 MiB data font mentah kumulatif; melampaui salah satu batas menolak pembaruan dan mempertahankan anotasi asli
API terkait
- SetLoadedFreeTextRichText memakai pipeline tampilan ini dengan overflow clip
- SetLoadedFreeTextPlainText mempertahankan kontrak ASCII aslinya
- SetLoadedAnnotationContents hanya menyunting konten tersimpan