THPDFHeadlessDocument.SetTextFieldValueWithAppearance

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

更新可写的末端 AcroForm 文本字段，并为每个既有控件构建显式 normal 外观；原生 Linux 与 Windows 使用同一份文档对象图

控件矩形提供外观尺寸；存在继承的字段 Q 时由其提供左、中或右对齐，否则应用选项中的对齐

此 profile 支持单行与多行纯文本、带字符回退的度量折行、CR/LF 换行、固定字号或自动适配、带正继承 MaxLen 的 comb 单元格，以及 90 度倍数的控件旋转

ShapeComplexText 启用时，复杂文字、bidi run、连字与 combining 序列使用 HarfBuzz 与 FriBidi；直接 Unicode 文本不依赖这些运行时，缺失字形或畸形代理对会产生外观诊断

复杂多行折行在 bidi 重排与重塑之前基于逻辑 Unicode 簇进行；comb 单元格保持每个标量一个字形的直接 profile

对既有富文本字段，此方法用单一纯文本样式替换内容并同步 V、RV 与每个控件外观；混合样式请用 SetRichTextFieldValueWithAppearance

密码字段按每个 Unicode 标量生成一个圆点，并在 V 中保留真实 Unicode 字段值；外观字形映射与无障碍文本包含掩码，值本身遵循文档加密策略

密码字段不能是多行或 comb 字段；畸形 Unicode、控制字符、缺失掩码字形、取消与资源耗尽都保留原字段

文件选择字段把字面 Unicode 路径当普通字段文本显示；此操作不会打开、执行或附加所选文件

字体要求有效的具名 TrueType 轮廓与真实度量，并带 installable 或 editable 嵌入标志；整字体内嵌遵守 no-subsetting 权限，拒绝 restricted、preview-and-print、bitmap-only、缺失与未知权限

方法在改动任何字段之前先准备好全部字段替换、外观字典、新字体与 Form 对象以及序列化预算；预检失败时保留原值与外观链接

新对象归文档所有，并通过原有有界增量写入器保存，包括按原 AES-256 R5 或 R6 策略加密新字符串与流

显式外观覆盖被修改字段后会清除 NeedAppearances，除非仍有其他纯值编辑或原始未解决的外观需求

原始标志为 true 时，其他非签名字段保守地保持 true，直到各自外观需求满足；请用独立的 choice 与按钮方法重新生成这些字段

只读、MaxLen、既有签名、认证权限、AES 表单填充权限、源保护、取消与原子输出策略继续生效

文档与外观选项同时指定取消 Token 时，两者必须是同一个 Token

有界字体与布局契约参见 THPDFHeadlessTextAppearanceOptions 与 HPDFBuildHeadlessTextAppearance