THotPDF.SetLoadedFreeTextText-metod
Ersätter det normala utseendet för en inläst FreeText-annotering med inbäddade Unicode-typsnitt, valfri rich text och en atomär graftransaktion
Deklaration
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');
Alternativ
Initiera posten med THPDFLoadedTextAppearanceOptions.Default innan enskilda fält ändras
| Fält | Beteende |
|---|---|
| FontName, FontStyle, FontSize | Primärt typsnitt, stil och punktstorlek; standardvärdena är Arial, regular och 12 punkter |
| TextColor, Alignment, Padding | Färg för vanlig text, vänster/centrerad/höger justering och punktutfyllnad; standardvärdena är svart, vänster och 2 punkter |
| Opacity, Rotation | Opacitet i [0,1] och rotation i multipler av 90 grader |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy: ltopReject avvisar överflöd, ltopClip klipper det och ltopShrinkToFit försöker igen med mindre typsnitt |
| MinFontSize | Nedre gräns för krympning, standard 4 punkter |
| MaxTextUnits | Budget för indata och vanlig text, standard 1,048,576 UTF-16-enheter; rich text-indata begränsas till fyra gånger denna budget |
Beteende
AText tillhandahåller vanlig Unicode-text; icke-tom UTF-8 RichContent använder i stället HTML-importören och valfri CSS DefaultStyle och härleder sedan /Contents från den genererade texten
Det genererade utseendet kopierar inbäddade typsnitt och ToUnicode-mappningar till det inlästa dokumentet, så att sparande, flattening och textextraktion behåller dess Unicode-text
Metoden ärver konfigurerade typsnittsreservkedjor, ShapingFeatures, auto-shaping-brytarna för arabiska, syrianska, N'Ko, Adlam och Hanifi Rohingya samt GSUB-skript- och språkvalen; varje shrink-to-fit-försök använder samma inställningar utan att ändra anroparens konfiguration
Den bevarar stött bakgrund, heldragen/streckad ram, rektangelinpassningar och två-/trepunkts callout-geometri, och synkroniserar /AP, /Contents, /RC, /DS, /CA, /Q och rotationsmetadata
Ogiltig geometri, olösta glyfer i vanlig text, cloudy-ramar, resursgränser och avvisat överflöd utlöser ett undantag och rullar tillbaka hela uppdateringen; befintliga yttre graftransaktioner förblir aktiva
Rich text följer den stödda HTML/CSS-delmängden; externa resurser är avstängda och fasta CSS-typsnittsstorlekar kan hindra shrink-to-fit från att minska enskilda körningar
Varje utseendeskrivare accepterar högst 256 olika shaping-typsnittsval och 64 MiB kumulativ rå typsnittsdata; att överskrida någon av gränserna avvisar uppdateringen och bevarar den ursprungliga annoteringen
Relaterade API:er
- SetLoadedFreeTextRichText använder den här utseendepipelinen med clip-överflöd
- SetLoadedFreeTextPlainText behåller sitt ursprungliga ASCII-kontrakt
- SetLoadedAnnotationContents redigerar endast lagrat innehåll