THPDFHeadlessDocument.SetTextFieldValueWithAppearance

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

Opdaterer et skrivbart terminal-AcroForm tekstfelt og bygger en eksplicit normal-appearance til hver eksisterende widget med den samme dokumentobjektgraf på native Linux og Windows

Widget-rektangler leverer appearance-dimensionerne; nedarvet felt Q leverer venstre-, center- eller højrejustering, når til stede, ellers gælder options justering

Profilen understøtter enkeltlinje- og multiline plain tekst, målt ordombrydning med tegn-fallback, CR/LF-linjeskift, fast størrelse eller auto-tilpas, comb-celler med et positivt nedarvet MaxLen samt widget-rotationer i multipla af 90 grader

Komplekse scripts, bidi-runs, ligaturer og combining-sekvenser bruger HarfBuzz og FriBidi, når ShapeComplexText er aktiveret; direkte Unicode-tekst forbliver uafhængig af de runtimes, og manglende glyphs eller misdannede surrogate-par giver en appearance-diagnostik

Kompleks multiline-ombrydning arbejder på logiske Unicode-clusters før bidi-omordning og reshaping; comb-celler beholder den direkte én-glyph-pr.-scalar-profil

For et eksisterende rich text-felt erstatter denne metode indholdet med én plain style og synkroniserer V, RV og hver widget-appearance; brug SetRichTextFieldValueWithAppearance til at levere blandede styles

Password-felter genererer én bullet pr. Unicode-scalar og beholder den faktiske Unicode-feltværdi i V; appearance glyph-mappings og tilgængelighedstekst indeholder masken, mens værdien følger dokumentkrypteringspolitikken

Password-felter kan ikke være multiline- eller comb-felter; misdannet Unicode, kontroltegn, manglende maske-glyphs, cancellation og ressourceopbrug bevarer det originale felt

File-select-felter viser den literal Unicode-sti som almindelig felttekst; operationen åbner, afvikler eller vedhæfter ikke den valgte fil

Fonts kræver gyldige navngivne TrueType-outlines og rigtige metrics med installérbar eller redigerbar embedding-flag; fuld-font-indlejring honorerer no-subsetting-tilladelser og afviser begrænsede, preview-and-print-, bitmap-kun, manglende og ukendte tilladelser

Metoden forbereder alle felterstatninger, appearance-dictionaries, nye font- og Form-objekter og serialiseringsbudgetter, før et felt ændres; preflight-fejl bevarer dets tidligere værdi og appearance-links

Nye objekter ejes af dokumentet og gemmes gennem den originale afgrænsede inkrementelle writer, inklusive kryptering af nye strenge og streams under den originale AES-256 R5- eller R6-politik

NeedAppearances ryddes, efter at eksplicitte appearances dækker det ændrede felt, medmindre en anden value-only-redigering eller et originals uopløst appearance-krav forbliver

Når det originale flag er true, beholder andre ikke-signaturfelter konservativt det true, indtil deres appearance-krav er opfyldt; brug de separate choice- og button-metoder til at regenerere de felter

Skrivebeskyttet, MaxLen, eksisterende signaturer, certificeringstilladelser, AES form-fill-tilladelser, kildebeskyttelse, cancellation og atomiske output-politikker forbliver gældende

Hvis både dokument- og appearance-options angiver cancellation-tokens, skal de være samme token

Se THPDFHeadlessTextAppearanceOptions og HPDFBuildHeadlessTextAppearance for den afgrænsede font- og layoutkontrakt