THPDFHeadlessDocument.SetTextFieldValueWithAppearance

procedure SetTextFieldValueWithAppearance(FieldIndex: Integer;
  const Text: UnicodeString; const TrueTypeFont: SysUtils.TBytes;
  const Options: THPDFHeadlessTextAppearanceOptions);

Aggiorna un campo testo AcroForm terminale scrivibile e costruisce una normal appearance esplicita per ogni widget esistente, usando lo stesso grafo di oggetti documento su Linux nativo e Windows

I rettangoli dei widget forniscono le dimensioni dell'appearance; il Q ereditato del campo fornisce allineamento left, center o right quando presente, altrimenti si applica l'allineamento delle opzioni

Il profilo supporta testo semplice a riga singola e multilinea, word wrapping misurato con fallback dei caratteri, interruzioni di riga CR/LF, size fissa o auto-fit, celle comb con MaxLen ereditato positivo e rotazioni dei widget a multipli di 90 gradi

Script complessi, run bidi, legature e sequenze combining usano HarfBuzz e FriBidi quando ShapeComplexText è abilitato; il testo Unicode diretto resta indipendente da quei runtime, e glyph mancanti o surrogate pair malformati producono un diagnostico dell'appearance

Il wrapping multilinea complesso opera sui cluster Unicode logici prima del riordino bidi e del reshaping; le celle comb conservano il profilo diretto one-glyph-per-scalar

Per un campo rich-text esistente, questo metodo sostituisce il contenuto con un unico stile semplice e sincronizza V, RV e ogni appearance dei widget; usa SetRichTextFieldValueWithAppearance per fornire stili misti

I campi password generano un bullet per ogni Unicode scalar e conservano il vero valore Unicode del campo in V; mappature glyph dell'appearance e testo di accessibilità contengono la maschera, mentre il valore segue la policy di cifratura del documento

I campi password non possono essere multilinea o comb; Unicode malformato, caratteri di controllo, glyph della maschera mancanti, cancellazione ed esaurimento risorse preservano il campo originale

I campi file-select mostrano il percorso Unicode letterale come testo ordinario del campo; questa operazione non apre, esegue né allega il file selezionato

I font richiedono outline TrueType nominali validi e metriche reali, con flag di incorporamento installable o editable; l'incorporamento del font completo onora i permessi no-subsetting e rifiuta permessi restricted, preview-and-print, bitmap-only, mancanti e sconosciuti

Il metodo prepara tutte le sostituzioni di campo, i dizionari appearance, i nuovi oggetti font e Form e i budget di serializzazione prima di modificare un campo; i fallimenti di preflight conservano il valore precedente e i collegamenti appearance

I nuovi oggetti sono di proprietà del documento e salvati tramite il consueto writer incrementale limitato, inclusa la cifratura di nuove stringhe e stream sotto la policy AES-256 R5 o R6 originale

NeedAppearances viene azzerato dopo che appearance esplicite coprono il campo modificato, a meno che resti un'altra modifica solo-valore o un requisito appearance originale non risolto

Quando il flag originale è true, gli altri campi non-firma lo conservano prudentemente a true finché i loro requisiti appearance non sono soddisfatti; usa i metodi separati per choice e pulsanti per rigenerare quei campi

Read-only, MaxLen, firme esistenti, permessi di certificazione, permessi form-fill AES, protezione della sorgente, cancellazione e policy di output atomico restano in vigore

Se sia il documento sia le opzioni appearance specificano cancellation token, devono essere lo stesso token

Vedi THPDFHeadlessTextAppearanceOptions e HPDFBuildHeadlessTextAppearance per il contratto limitato di font e layout