Phương thức THotPDF.SetLoadedFreeTextText
Thay thế normal appearance của một chú thích FreeText đã nạp bằng font Unicode nhúng, rich text tùy chọn, và một graph transaction nguyên tử
Khai báo
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');
Tùy chọn
Hãy khởi tạo record bằng THPDFLoadedTextAppearanceOptions.Default trước khi thay đổi từng trường
| Trường | Hành vi |
|---|---|
| FontName, FontStyle, FontSize | Font chính, style, và cỡ point; mặc định là Arial, regular, và 12 points |
| TextColor, Alignment, Padding | Màu plain-text, căn trái/giữa/phải, và padding theo point; mặc định là đen, trái, và 2 points |
| Opacity, Rotation | Opacity trong [0,1] và xoay theo bội số của 90 độ |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy: ltopReject từ chối tràn, ltopClip cắt nó, và ltopShrinkToFit thử lại với font nhỏ hơn |
| MinFontSize | Chặn dưới khi thu nhỏ, mặc định 4 points |
| MaxTextUnits | Ngân sách input và plain-text, mặc định 1,048,576 UTF-16 units; rich input bị giới hạn gấp bốn lần ngân sách này |
Hành vi
AText cung cấp văn bản Unicode trơn; RichContent UTF-8 khác rỗng thì thay vào đó dùng HTML importer cùng DefaultStyle CSS tùy chọn, rồi suy ra /Contents từ văn bản được tạo
Appearance được tạo sao chép font nhúng và mapping ToUnicode vào tài liệu đã nạp, nên việc lưu, flatten, và trích xuất văn bản vẫn giữ được văn bản Unicode của nó
Phương thức thừa kế các chuỗi font fallback đã cấu hình, ShapingFeatures, các công tắc auto-shaping Arabic, Syriac, N'Ko, Adlam, và Hanifi Rohingya, cùng các lựa chọn GSUB script và language; mọi lần thử lại shrink-to-fit dùng cùng các thiết lập mà không đổi cấu hình của caller
Nó bảo toàn nền được hỗ trợ, viền solid/dashed, inset hình chữ nhật, và hình học callout hai/ba điểm, đồng bộ /AP, /Contents, /RC, /DS, /CA, /Q, và metadata xoay
Hình học không hợp lệ, glyph plain-text chưa giải quyết được, viền cloudy, giới hạn tài nguyên, và tràn bị từ chối đều raise exception và rollback toàn bộ cập nhật; graph transaction bên ngoài đang mở vẫn tiếp tục hoạt động
Rich text tuân theo tập con HTML/CSS được hỗ trợ; tài nguyên bên ngoài bị tắt và cỡ font CSS cố định có thể khiến shrink-to-fit không thu nhỏ được từng run riêng lẻ
Mỗi appearance writer chấp nhận tối đa 256 lựa chọn shaping font phân biệt và 64 MiB dữ liệu font thô tích lũy; vượt bất kỳ giới hạn nào cũng từ chối cập nhật và bảo toàn chú thích gốc
API liên quan
- SetLoadedFreeTextRichText dùng pipeline appearance này với tràn kiểu clip
- SetLoadedFreeTextPlainText giữ nguyên hợp đồng ASCII gốc của nó
- SetLoadedAnnotationContents chỉ sửa nội dung đã lưu