THPDFHeadlessDocument.SetTextFieldValueWithAppearance

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

Aktualisiert ein beschreibbares terminal AcroForm-Textfeld und baut für jedes bestehende Widget eine explizite Normal-Appearance auf, mit demselben Dokumentobjektgraph auf nativem Linux und Windows

Widget-Rechtecke liefern die Appearance-Abmessungen; das geerbte Feld-Q liefert Links-, Mittel- oder Rechtsausrichtung, wenn vorhanden, andernfalls greift die Options-Ausrichtung

Das Profil unterstützt einzeiligen und mehrzeiligen Plain-Text, gemessenen Word Wrapping mit Zeichen-Fallback, CR/LF-Zeilenumbrüche, feste Größe oder Auto-Fit, comb-Zellen mit positivem geerbtem MaxLen sowie Widget-Rotationen in Vielfachen von 90 Grad

Komplexe Skripte, bidi-Runs, Ligaturen und kombinierende Sequenzen nutzen HarfBuzz und FriBidi, wenn ShapeComplexText aktiviert ist; direkter Unicode-Text bleibt unabhängig von diesen Runtimes, und fehlende Glyphen oder missgebildete Surrogate-Paare erzeugen eine Appearance-Diagnose

Komplexes mehrzeiliges Wrapping arbeitet auf logischen Unicode-Clustern vor bidi-Neuordnung und Reshaping; comb-Zellen behalten das direkte Eine-Glyphe-pro-Scalar-Profil

Bei einem bestehenden Rich-Text-Feld ersetzt diese Methode den Inhalt durch einen einzigen Plain-Stil und synchronisiert V, RV und jede Widget-Appearance; nutzen Sie SetRichTextFieldValueWithAppearance, um gemischte Stile zu liefern

Passwortfelder erzeugen ein Bullet pro Unicode-Scalar und behalten den echten Unicode-Feldwert in V; Appearance-Glyphen-Zuordnungen und Accessibility-Text enthalten die Maske, während der Wert der Dokumentverschlüsselungs-Policy folgt

Passwortfelder können keine multiline- oder comb-Felder sein; missgebildetes Unicode, Steuerzeichen, fehlende Maskenglyphen, Abbruch und Ressourcenerschöpfung bewahren das Originalfeld

Dateiauswahl-Felder zeigen den buchstäblichen Unicode-Pfad als gewöhnlichen Feldtext; diese Operation öffnet, führt die gewählte Datei nicht aus und hängt sie nicht an

Schriften verlangen gültige benannte TrueType-Konturen und echte Metriken, mit installable- oder editable-Embedding-Flags; Full-Font-Embedding beachtet No-Subsetting-Berechtigungen und weist restricted-, preview-and-print-, bitmap-only-, fehlende und unbekannte Berechtigungen zurück

Die Methode bereitet alle Feldersetzungen, Appearance-Dictionaries, neue Font- und Form-Objekte und Serialisierungs-Budgets vor, bevor sie ein Feld ändert; Preflight-Fehlschläge bewahren den vorherigen Wert und die Appearance-Links

Neue Objekte gehören dem Dokument und werden über den ursprünglichen begrenzten inkrementellen Writer gespeichert, einschließlich Verschlüsselung neuer Strings und Streams unter der ursprünglichen AES-256-R5- oder R6-Policy

NeedAppearances wird gelöscht, nachdem explizite Appearances das geänderte Feld abdecken, sofern nicht eine weitere reine Wertbearbeitung oder eine ursprüngliche unaufgelöste Appearance-Anforderung bestehen bleibt

Ist das ursprüngliche Flag true, behalten andere Nicht-Signatur-Felder es konservativ bei true, bis ihre Appearance-Anforderungen erfüllt sind; nutzen Sie die separaten Choice- und Button-Methoden, um diese Felder zu regenerieren

Schreibschutz, MaxLen, bestehende Signaturen, Zertifizierungsberechtigungen, AES-Formularfüllberechtigungen, Quellschutz, Abbruch und atomare Output-Policys bleiben wirksam

Geben sowohl die Dokument- als auch die Appearance-Optionen Abbruch-Token an, müssen sie dasselbe Token sein

Siehe THPDFHeadlessTextAppearanceOptions und HPDFBuildHeadlessTextAppearance für den begrenzten Font- und Layout-Vertrag