THotPDF.SetLoadedFreeTextText Method

Sostituisce la appearance normale di un'annotazione FreeText caricata usando font Unicode incorporati, rich text opzionale e una transazione atomica del grafo

Dichiarazione

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

Opzioni

Inizializzare il record con THPDFLoadedTextAppearanceOptions.Default prima di modificare i singoli campi

CampoComportamento
FontName, FontStyle, FontSizeFont principale, stile e dimensione in punti; i predefiniti sono Arial, regular e 12 punti
TextColor, Alignment, PaddingColore del testo semplice, allineamento sinistra/centro/destra e padding in punti; i predefiniti sono nero, sinistra e 2 punti
Opacity, RotationOpacità in [0,1] e rotazione a multipli di 90 gradi
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject respinge l'overflow, ltopClip lo taglia, e ltopShrinkToFit riprova con font più piccoli
MinFontSizeLimite inferiore per la riduzione, predefinito 4 punti
MaxTextUnitsBudget dell'input e del testo semplice, predefinito 1,048,576 unità UTF-16; l'input rich è limitato a quattro volte questo budget

Comportamento

AText fornisce testo Unicode semplice; un RichContent UTF-8 non vuoto usa invece l'importer HTML e l'opzionale CSS DefaultStyle, poi deriva /Contents dal testo generato

La appearance generata copia nel documento caricato i font incorporati e le mappature ToUnicode, così che salvataggio, flattening ed estrazione del testo ne conservino il testo Unicode

Il metodo eredita le catene di font fallback configurate, ShapingFeatures, gli interruttori di auto-shaping per arabo, siriaco, N'Ko, Adlam e Hanifi Rohingya, e le selezioni di script e lingua GSUB; ogni retry di shrink-to-fit usa le stesse impostazioni senza cambiare la configurazione del chiamante

Conserva il background supportato, i bordi solidi/tratteggiati, gli inset del rettangolo e la geometria callout a due/tre punti, e sincronizza /AP, /Contents, /RC, /DS, /CA, /Q e i metadati di rotazione

Geometria non valida, glifi di testo semplice non risolti, bordi cloudy, limiti di risorse e overflow respinto sollevano un'eccezione e fanno rollback dell'intero aggiornamento; le transazioni esterne del grafo già attive restano attive

Il rich text segue il subset HTML/CSS supportato; le risorse esterne sono disabilitate e le dimensioni CSS dei font fisse possono impedire allo shrink-to-fit di ridurre le singole run

Ogni appearance writer accetta al massimo 256 selezioni distinte di font di shaping e 64 MiB di dati font grezzi cumulativi; il superamento di uno dei due limiti respinge l'aggiornamento e preserva l'annotazione originale

API correlate