THotPDF.SetLoadedFreeTextText Method

Nahradí normal appearance načtené FreeText anotace pomocí vložených Unicode fontů, volitelného rich textu a atomické transakce grafu

Deklarace

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

Volby

Záznam inicializujte přes THPDFLoadedTextAppearanceOptions.Default, než začnete měnit jednotlivá pole

PoleChování
FontName, FontStyle, FontSizeHlavní font, styl a velikost v bodech; výchozí jsou Arial, regular a 12 bodů
TextColor, Alignment, PaddingBarva prostého textu, zarovnání doleva/na střed/doprava a odsazení v bodech; výchozí jsou černá, doleva a 2 body
Opacity, RotationNeprůhlednost v [0,1] a rotace v násobcích 90 stupňů
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject přetečení odmítne, ltopClip ho ořízne a ltopShrinkToFit to zkusí znovu s menšími fonty
MinFontSizeSpodní mez pro zmenšování, výchozí 4 body
MaxTextUnitsLimit vstupu a prostého textu, výchozí 1,048,576 jednotek UTF-16; rich vstup se omezuje na čtyřnásobek tohoto limitu

Chování

AText dodá prostý Unicode text; neprázdný UTF-8 RichContent místo toho použije HTML importer a volitelný CSS DefaultStyle a poté odvodí /Contents z vygenerovaného textu

Vygenerovaný vzhled zkopíruje vložené fonty a mapování ToUnicode do načteného dokumentu, takže ukládání, flattening i extrakce textu si jeho Unicode text zachovají

Metoda dědí nakonfigurované font fallback řetězce, ShapingFeatures, přepínače auto-shaping pro arabštinu, syrštinu, N'Ko, Adlam i Hanifi Rohingya a výběry GSUB script a jazyka; každý pokus shrink-to-fit použije tatáž nastavení bez změny konfigurace volajícího

Zachová podporované pozadí, solid/dashed rámeček, insets obdélníku a callout geometrii se dvěma/třemi body a synchronizuje /AP, /Contents, /RC, /DS, /CA, /Q i metadata rotace

Neplatná geometrie, nevyřešené glyfy prostého textu, cloudy rámečky, limity zdrojů i odmítnuté přetečení vyhodí výjimku a celou aktualizaci odrolují; existující vnější transakce grafu zůstávají aktivní

Rich text se řídí podporovanou podmnožinou HTML/CSS; externí zdroje jsou zakázané a pevné CSS velikosti fontu mohou zabránit, aby shrink-to-fit zmenšil jednotlivé běhy textu

Každý writer vzhledu přijme nejvýše 256 odlišných shaping výběrů fontu a 64 MiB kumulativních surových fontových dat; překročení kterhokoli limitu aktualizaci odmítne a původní anotaci zachová

Související API