THPDFHeadlessDocument.SetTextFieldValueWithAppearance

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

Werkt een schrijfbaar terminal-AcroForm-tekstveld bij en bouwt een expliciete normale appearance voor elke bestaande widget, met dezelfde documentobjectgraaf op native Linux en Windows

Widget-rechthoeken leveren de appearance-dimensies; geërfde veld Q levert left-, center- of right-uitlijning wanneer aanwezig, anders geldt de uitlijning van de options

Het profiel ondersteunt single-line- en multiline-platte tekst, gemeten woordwrapping met character-fallback, CR/LF-regeleindes, vaste grootte of auto-fit, comb-cellen met een positieve geërfde MaxLen en widget-rotaties in veelvouden van 90 graden

Complexe scripts, bidi-runs, ligatures en combining-sequenties gebruiken HarfBuzz en FriBidi wanneer ShapeComplexText aan staat; directe Unicode-tekst blijft onafhankelijk van die runtimes, en ontbrekende glyphs of misvormde surrogate pairs leveren een appearance-diagnostiek op

Complexe multiline-wrapping opereert op logische Unicode-clusters vóór bidi-herordening en reshaping; comb-cellen behouden het directe één-glyph-per-scalar-profiel

Voor een bestaand rich-text-veld vervangt deze methode de content door één platte stijl en synchroniseert V, RV en elke widget-appearance; gebruik SetRichTextFieldValueWithAppearance om gemengde stijlen te leveren

Password-velden genereren één bullet per Unicode-scalar en behouden de echte Unicode-veldwaarde in V; appearance-glyph-mappings en toegankelijkheidstekst bevatten het masker, terwijl de waarde het document-encryptiebeleid volgt

Password-velden kunnen geen multiline- of comb-velden zijn; misvormde Unicode, controletekens, ontbrekende masker-glyphs, annulering en resource-uitputting behouden het originele veld

File-select-velden tonen het letterlijke Unicode-pad als gewone veldtekst; deze operatie opent, voert niet uit en voegt het gekozen bestand niet toe

Fonts vragen geldige benoemde TrueType-outlines en echte metrics, met installable- of editable-embedding-vlaggen; full-font-embedding honoreert no-subsetting-permissions en verwerpt restricted-, preview-and-print-, bitmap-only-, ontbrekende en onbekende permissions

De methode bereidt alle veldvervangingen, appearance-dictionaries, nieuwe font- en Form-objecten en serialisatiebudgetten voor voordat een veld wordt gewijzigd; preflight-falen behoudt diens vorige waarde en appearance-links

Nieuwe objecten zijn in document-eigendom en worden opgeslagen via de originele begrensde incrementele writer, inclusief encryptie van nieuwe strings en streams onder het originele AES-256 R5- of R6-beleid

NeedAppearances wordt gewist nadat expliciete appearances het gewijzigde veld dekken, tenzij een andere value-only-edit of een originele onopgeloste appearance-vereiste resteert

Wanneer de originele vlag true is, houden andere niet-signature-velden hem conservatief true tot aan diens appearance-vereisten zijn voldaan; gebruik de aparte choice- en button-methodes om die velden te regenereren

Read-only, MaxLen, bestaande signatures, certification-permissions, AES form-fill-permissions, bronbescherming, annulering en atomaire uitvoer-policies blijven van kracht

Wanneer zowel de document- als appearance-options annuleringstokens specificeren, moeten ze dezelfde token zijn

Zie THPDFHeadlessTextAppearanceOptions en HPDFBuildHeadlessTextAppearance voor het begrensde font- en layout-contract