THPDFHeadlessDocument.SetTextFieldValueWithAppearance

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

Uppdaterar ett skrivbart terminal-AcroForm-textfält och bygger ett explicit normalt utseende för varje befintlig widget, med samma dokumentobjektgraf på native Linux och Windows

Widgetrektanglarna ger utseendets dimensioner; ärvd fält-Q ger vänster-, center- eller högerjustering när den finns, annars gäller alternativens justering

Profilen stöder enkelradig och flerradig vanlig text, uppmätt ordbrytning med teckenfallback, CR/LF-radbrytningar, fast storlek eller auto-anpassning, comb-celler med positiv ärvd MaxLen samt widgetrotationer i multipler av 90 grader

Komplexa skript, bidi-runs, ligaturer och kombinerande sekvenser använder HarfBuzz och FriBidi när ShapeComplexText är aktiverat; direkt Unicode-text förblir oberoende av de runtime:erna, och saknade glyfer eller felutformade surrogatpar ger en utseendediagnostik

Komplex flerradig radbrytning arbetar på logiska Unicode-kluster före bidi-omordning och omformning; comb-celler behåller den direkta profilen med en glyf per skalär

För ett befintligt rich-text-fält ersätter denna metod innehållet med en enda enkel stil och synkroniserar V, RV och varje widgets utseende; använd SetRichTextFieldValueWithAppearance för att ange blandade stilar

Lösenordsfält genererar en punkt per Unicode-skalär och behåller det faktiska Unicode-fältvärdet i V; utseendets glyfmappningar och tillgänglighetstext innehåller masken, medan värdet följer dokumentets krypteringspolicy

Lösenordsfält kan inte vara flerradiga eller comb-fält; felutformad Unicode, kontrolltecken, saknade maskglyfer, avbrott och resursbrist bevarar originalfältet

Filvalsfält visar den litterala Unicode-sökvägen som vanlig fälttext; operationen öppnar, kör eller bifogar inte den valda filen

Typsnitt kräver giltiga namngivna TrueType-konturer och faktiska mått, med inbäddningsflaggorna installable eller editable; fullständig typsnittsinbäddning respekterar behörigheten no-subsetting och avvisar restricted, preview-and-print, bitmap-only, saknade samt okända behörigheter

Metoden förbereder alla fältersättningar, utseendediktionärer, nya typsnitts- och Form-objekt samt serialiseringsbudgetar innan ett fält ändras; preflight-fel bevarar dess tidigare värde och utseendelänkar

Nya objekt ägs av dokumentet och sparas via den ursprungliga avgränsade inkrementella skrivaren, inklusive kryptering av nya strängar och strömmar under den ursprungliga policyn AES-256 R5 eller R6

NeedAppearances rensas efter att explicita utseenden täcker det ändrade fältet, såvida inte en annan värdeändring utan utseende eller ett ursprungligt olöst utseendekrav kvarstår

När den ursprungliga flaggan är true behåller andra fält utan signaturer den konservativt som true tills deras utseendekrav är uppfyllda; använd de separata metoderna för val och knappar för att återskapa de fälten

Skrivskydd, MaxLen, befintliga signaturer, certifieringsbehörigheter, AES-behörigheter för formulärfyllning, källskydd, avbrott och atomära utmatningspolicyer förblir gällande

Om både dokumentet och utseendealternativen anger avbrytningstoken:er måste det vara samma token

Se THPDFHeadlessTextAppearanceOptions och HPDFBuildHeadlessTextAppearance för det avgränsade kontraktet för typsnitt och layout