THotPDF.SetLoadedFreeTextPlainText Method

Converte in modo esplicito un'annotazione FreeText caricata supportata in testo normale allineato a sinistra e ricostruisce il suo aspetto normale

Dichiarazione

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

Unità: HPDFDoc · Disponibile dalla Version 2.753.0

Parametri

• PageIndex: indice con base zero della pagina caricata
• AnnotationIndex: indice con base zero dell'annotazione su quella pagina
• AText: caratteri ASCII stampabili, con CR, LF o CR/LF per le interruzioni di riga esplicite; tab, altri caratteri di controllo e testo non ASCII vengono rifiutati
• FontSize: dimensione finita in punti PDF, maggiore di zero e al massimo 10.000, con 12 come predefinito

Conversione dell'aspetto

Il metodo usa testo Helvetica nero e un bordo rettangolare nero, conserva uno sfondo in device color supportato e la geometria del bordo solido o tratteggiato, e ritaglia il testo a un rientro di due punti entro il rettangolo dell'annotazione

Le righe avanzano di 1,2 volte la dimensione del font; non c'è wrapping automatico né adattamento per riduzione, quindi il testo fuori dal rientro viene ritagliato

La conversione sostituisce /AP, aggiorna /Contents e /DA, porta /Q a zero e rimuove /RC, /DS e /AS; il vecchio testo rich, la selezione del font, il colore del testo, l'allineamento e gli stati di aspetto vengono sostituiti di proposito

Le modifiche ad annotazione, aspetto e pagina vengono registrate per il salvataggio incrementale e la cache di rendering della pagina viene invalidata; anche il salvataggio per riscrittura conserva il nuovo aspetto

Input supportato ed errori

L'annotazione deve esistere e avere subtype FreeText, con un rettangolo finito più largo e più alto di quattro punti

Callout, differenze o rientri del rettangolo, effetti sul bordo, una voce di rotazione, intent non FreeText, annotazioni non opache, bordi arrotondati e stili di bordo diversi da solido o tratteggiato vengono rifiutati con EArgumentException

Le componenti dello sfondo DeviceGray, DeviceRGB e DeviceCMYK devono stare tra zero e uno; larghezze del bordo e pattern di tratteggio devono essere validi, finiti e non negativi, e un pattern di tratteggio non vuoto tutto a zero viene rifiutato

L'input non supportato viene validato prima di sostituire l'annotazione o il suo aspetto

Esempio

Per un documento caricato la cui prima annotazione sulla pagina zero è un'annotazione FreeText supportata

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

API correlate

SetLoadedAnnotationContents cambia solo la stringa dei contenuti memorizzata e conserva l'aspetto esistente

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Home