THotPDF.SetLoadedFreeTextText metódus
Betöltött FreeText annotáció normál megjelenését cseréli beágyazott Unicode fontokkal, opcionális rich texttel és atomi gráftranzakcióval
Deklaráció
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');
Beállítások
Az egyes mezők módosítása előtt inicializálja a rekordot a THPDFLoadedTextAppearanceOptions.Default értékkel
| Mező | Viselkedés |
|---|---|
| FontName, FontStyle, FontSize | Elsődleges font, stílus és pontméret; az alapértékek Arial, regular és 12 pont |
| TextColor, Alignment, Padding | Az egyszerű szöveg színe, bal/közép/jobbra igazítás és pont-térköz; az alapértékek fekete, bal és 2 pont |
| Opacity, Rotation | Átlátszatlanság a [0,1] tartományban és elforgatás 90 fok többszöröseiben |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy: az ltopReject elutasítja a túlcsordulást, az ltopClip levágja, az ltopShrinkToFit pedig kisebb fontokkal próbálkozik újra |
| MinFontSize | A zsugorítás alsó határa, alapértelmezetten 4 pont |
| MaxTextUnits | Bemeneti és egyszerű szöveg keret, alapértelmezetten 1,048,576 UTF-16 egység; a rich bemenet ennek a keretnek a négyszeresére korlátozott |
Viselkedés
Az AText egyszerű Unicode szöveget ad; a nem üres UTF-8 RichContent ehelyett a HTML importert és az opcionális CSS DefaultStyle-t használja, majd a generált szövegből származtatja a /Contents értéket
A generált megjelenés beágyazott fontokat és ToUnicode leképezéseket másol a betöltött dokumentumba, így a mentés, a laposítás (flattening) és a szövegkinyerés megőrzi annak Unicode szövegét
A metódus örökli a konfigurált font tartalékláncokat, a ShapingFeatures értéket, az arab, szíriai, N'Ko, Adlam és Hanifi Rohingya auto-shaping kapcsolókat, valamint a GSUB írásrendszer- és nyelvválasztásokat; minden shrink-to-fit újrapróbálkozás ugyanazokat a beállításokat használja a hívó konfigurációjának módosítása nélkül
Megőrzi a támogatott hátteret, a folytonos/szaggatott keretet, a téglalap-betéteket és a két-/hárompontos callout geometriát, és szinkronizálja a /AP, /Contents, /RC, /DS, /CA, /Q és elforgatási metaadatokat
Az érvénytelen geometria, a megoldatlan egyszerű szöveges glifek, a felhős keretek, az erőforráskorlátok és az elutasított túlcsordulás kivételt dob, és visszagörgeti a teljes frissítést; a meglévő külső gráftranzakciók aktívak maradnak
A rich text a támogatott HTML/CSS részhalmazt követi; a külső erőforrások le vannak tiltva, és a fix CSS fontméretek megakadályozhatják, hogy a shrink-to-fit az egyes szövegfutásokat kicsinyítse
Minden megjelenés-író legfeljebb 256 különböző shaping fontválasztást és 64 MiB kumulált nyers fontadatot fogad el; valamely korlát túllépése elutasítja a frissítést, és megőrzi az eredeti annotációt
Kapcsolódó API-k
- A SetLoadedFreeTextRichText ugyanezt a megjelenés-előállító láncot használja clip túlcsordulással
- A SetLoadedFreeTextPlainText megtartja eredeti ASCII kontraktusát
- A SetLoadedAnnotationContents csak a tárolt tartalmat szerkeszti