THPDFHeadlessDocument.SetTextFieldValueWithAppearance

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

更新可寫入的終端 AcroForm 文字欄位，並為每個既有 widget 建立明確的 normal 外觀，原生 Linux 與 Windows 使用同一套文件物件圖

外觀尺寸取自 widget 矩形；繼承的欄位 Q 存在時提供靠左、置中或靠右對齊，否則採用選項的對齊設定

這個設定檔支援單行與多行純文字、含字元 fallback 的量測換行、CR/LF 斷行、固定大小或 auto-fit、具正繼承 MaxLen 的 comb 儲存格，以及 90 度倍數的 widget 旋轉

ShapeComplexText 啟用時，複雜文字、bidi runs、連字與 combining 序列會使用 HarfBuzz 與 FriBidi；直接 Unicode 文字不依賴那些 runtime，缺 glyph 或格式錯誤的 surrogate pair 會產生外觀診斷

複雜多行換行在 bidi 重排與重塑之前，以邏輯 Unicode cluster 為單位運作；comb 儲存格維持每個 scalar 一個 glyph 的直接設定檔

對既有的 rich-text 欄位，此方法會以單一純文字樣式取代內容，並同步 V、RV 與每個 widget 外觀；混合樣式請改用 SetRichTextFieldValueWithAppearance

密碼欄位為每個 Unicode scalar 產生一個圓點，並在 V 保留實際 Unicode 欄位值；外觀 glyph 對應與無障礙文字含遮罩，值本身遵循文件加密政策

密碼欄位不可為 multiline 或 comb 欄位；格式錯誤的 Unicode、控制字元、缺少遮罩 glyph、取消與資源耗盡都會保留原欄位

檔案選擇欄位以一般欄位文字顯示字面的 Unicode 路徑；此操作不會開啟、執行或附加選定的檔案

字型必須具有有效的具名 TrueType 輪廓與實際 metrics，並帶 installable 或 editable 內嵌旗標；完整字型內嵌遵守 no-subsetting 權限，並拒絕 restricted、preview-and-print、bitmap-only、缺失與未知權限

方法會在修改欄位之前備妥所有欄位替換、外觀 dictionary、新的字型與 Form 物件以及序列化預算；preflight 失敗時保留先前的值與外觀連結

新物件由文件持有，並透過原本的有界增量寫入器儲存，包括在原始 AES-256 R5 或 R6 政策下加密新字串與 stream

明確外觀涵蓋變更欄位後會清除 NeedAppearances，除非仍有其他僅更新值的編輯，或原本就有未解決的外觀需求

原始旗標為 true 時，其他非簽章欄位會保守地維持 true，直到自身外觀需求滿足為止；請使用獨立的選擇與按鈕方法重新產生那些欄位

唯讀、MaxLen、既有簽章、認證權限、AES 表單填寫權限、來源保護、取消與原子輸出政策持續生效

文件與外觀選項都指定 cancellation token 時，兩者必須是同一個 token

有界字型與版面契約請參閱 THPDFHeadlessTextAppearanceOptions 與 HPDFBuildHeadlessTextAppearance