THotPDF.SetLoadedFreeTextText Metodu
Yüklenmiş bir FreeText annotation'ının normal appearance'ını, gömülü Unicode fontları, isteğe bağlı rich text ve atomik bir graph transaction ile değiştirir
Bildirim
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');
Seçenekler
Tekil alanları değiştirmeden önce record'ı THPDFLoadedTextAppearanceOptions.Default ile başlatın
| Alan | Davranış |
|---|---|
| FontName, FontStyle, FontSize | Birincil font, stil ve point boyutu; varsayılanlar Arial, regular ve 12 point |
| TextColor, Alignment, Padding | Düz metin rengi, left/center/right alignment ve point padding; varsayılanlar black, left ve 2 point |
| Opacity, Rotation | [0,1] aralığında opacity ve 90 derecenin katları olarak rotation |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy: ltopReject taşmayı reddeder, ltopClip kırpar, ltopShrinkToFit daha küçük fontlarla yeniden dener |
| MinFontSize | Küçültme alt sınırı, varsayılan 4 point |
| MaxTextUnits | Girdi ve düz metin bütçesi, varsayılan 1,048,576 UTF-16 unit; rich girdi bu bütçenin dört katıyla sınırlıdır |
Davranış
AText düz Unicode metin sağlar; boş olmayan UTF-8 RichContent bunun yerine HTML importer'ı ve isteğe bağlı CSS DefaultStyle'ı kullanır, ardından /Contents'i üretilen metinden türetir
Üretilen appearance, gömülü fontları ve ToUnicode mapping'lerini yüklenmiş belgeye kopyalar; böylece kaydetme, flatten etme ve metin çıkarma Unicode metnini korur
Metot; yapılandırılmış font fallback zincirlerini, ShapingFeatures'i, Arapça, Süryanice, N'Ko, Adlam ve Hanifi Rohingya auto-shaping anahtarlarını ve GSUB script ile dil seçimlerini miras alır; her shrink-to-fit yeniden denemesi, caller'ın yapılandırmasını değiştirmeden aynı ayarları kullanır
Desteklenen background'ı, solid/dashed border'ı, rectangle inset'lerini ve iki/üç noktalı callout geometrisini korur ve /AP, /Contents, /RC, /DS, /CA, /Q ile rotation metadata'sını senkronize eder
Geçersiz geometri, çözümlenemeyen düz metin glyph'leri, cloudy border'lar, kaynak limitleri ve reddedilen taşma exception fırlatır ve güncellemenin tamamını geri alır; mevcut dış graph transaction'lar aktif kalır
Rich text, desteklenen HTML/CSS subset'ini izler; harici kaynaklar devre dışıdır ve sabit CSS font boyutları, shrink-to-fit'in tekil run'ları küçültmesini engelleyebilir
Her appearance writer, en fazla 256 farklı shaping font seçimini ve 64 MiB kümülatif ham font verisini kabul eder; iki limitten biri aşıldığında güncelleme reddedilir ve orijinal annotation korunur
İlgili API'ler
- SetLoadedFreeTextRichText bu appearance pipeline'ını clip overflow ile kullanır
- SetLoadedFreeTextPlainText orijinal ASCII sözleşmesini korur
- SetLoadedAnnotationContents yalnızca saklanan içeriği düzenler