THotPDF.SetLoadedFreeTextText Method
Nahrádza normálny vzhľad načítanej FreeText anotácie pomocou vložených Unicode písiem, voliteľného rich textu a atomickej transakcie grafu
Deklarácia
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');
Voľby
Záznam inicializujte cez THPDFLoadedTextAppearanceOptions.Default skôr, než zmeníte jednotlivé polia
| Pole | Správanie |
|---|---|
| FontName, FontStyle, FontSize | Hlavné písmo, štýl a veľkosť v bodoch; predvolené sú Arial, regular a 12 bodov |
| TextColor, Alignment, Padding | Farba čistého textu, zarovnanie doľava/na stred/doprava a odsadenie v bodoch; predvolené sú čierna, doľava a 2 body |
| Opacity, Rotation | Nepriehľadnosť v [0,1] a rotácia v násobkoch 90 stupňov |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy: ltopReject pretečenie odmietne, ltopClip ho oreže a ltopShrinkToFit opakuje pokus s menšími písmami |
| MinFontSize | Dolná hranica pre zmenšovanie, predvolené 4 body |
| MaxTextUnits | Rozpočet vstupu a čistého textu, predvolene 1,048,576 UTF-16 jednotiek; rich text vstup má limit štyrikrát väčší ako tento rozpočet |
Správanie
AText dodáva čistý Unicode text; neprázdny UTF-8 RichContent namiesto toho použije HTML importer a voliteľný CSS DefaultStyle a potom odvodí /Contents z generovaného textu
Generovaný vzhľad skopíruje vložené písma a ToUnicode mapovania do načítaného dokumentu, takže ukladanie, sploštenie a extrakcia textu zachovajú jeho Unicode text
Metóda zdedí nakonfigurované fallback reťazce písiem, ShapingFeatures, prepínače auto-shapingu pre arabské, sýrske, N'Ko, Adlam a Hanifi Rohingya písmo a výbery GSUB scriptu a jazyka; každý pokus shrink-to-fit používa tie isté nastavenia bez zmeny konfigurácie volajúceho
Zachováva podporované pozadie, plný/prerušovaný rámec, vnútorné okraje obdĺžnika a callout geometriu s dvomi/tromi bodmi a synchronizuje /AP, /Contents, /RC, /DS, /CA, /Q a metadáta rotácie
Neplatná geometria, nevyriešené glyfy čistého textu, obláčikové rámce, limity zdrojov a odmietnuté pretečenie vyvolajú výnimku a vrátia späť celú aktualizáciu; existujúce vonkajšie transakcie grafu zostávajú aktívne
Rich text sa riadi podporovanou podmnožinou HTML/CSS; externé zdroje sú vypnuté a pevné veľkosti CSS písiem môžu zabrániť tomu, aby shrink-to-fit zmenšil jednotlivé úseky
Každý zapisovač vzhľadu prijme najviac 256 rôznych shaping výberov písma a 64 MiB kumulatívnych surových dát písiem; prekročenie ktorejkoľvek hranice aktualizáciu odmietne a zachová pôvodnú anotáciu
Súvisiace API
- SetLoadedFreeTextRichText používa toto pipeline tvorby vzhľadov s orezaním pretečenia
- SetLoadedFreeTextPlainText si zachováva pôvodný ASCII kontrakt
- SetLoadedAnnotationContents mení len uložený obsah