THPDFHeadlessDocument.SaveRichTextFieldUpdatesToFile

function SaveRichTextFieldUpdatesToFile(const FileName: string;
  const Updates: THPDFHeadlessRichTextFieldUpdates;
  const Options: THPDFHeadlessFormDataOptions): Integer;

准备并原子发布一个独立 PDF，包含标量文本、choice 与按钮更新以及原始 typed 富文本 run；返回变更字段数量，已加载文档对象图保持不变

应用更新之前，当前对象图先序列化成私有已认证修订；既有的未保存页面与字段编辑、AES R5/R6 凭据、加密标识与已签名源前缀对候选仍然可用

typed run 直接生成外观，没有富 XML 编解码往返；/V 与 /RV 描述 authored 文本与样式，/AP 对原始 typed 尺寸与颜色保留既有外观引擎的 PDF 数值精度

typed no-op 要求纯文本与富值等价，且每个控件的生成外观流与解析后的字体/资源图都相同；比较会解密既有流并规范化间接对象引用，而不是只信量化的 /RV 颜色

这让真正未变化的只读或签名锁定字段得以通过；只要实际绘制颜色、字号、supplied 字体或控件外观不同，即使序列化富值恰好相同，也照常受只读、FieldMDP 与 DocMDP 限制

对既有外观的比较偏保守：外部 PDF 视觉等价但算子或资源表示不同时，可能仍需普通受保护更新；此 API 不承诺字节相同的 no-op 输出

字段数量、重复名称、Unicode、值大小与聚合文本容量用 Options；typed run 数量、聚合字形单元、supplied 字体字节、富值字节、生成对象与外观比较字节还受已加载文档限制

共享的托管字节数组在多个更新间只计一次；不同分配即使字节相同也各占独立的输入字体容量，生成的 PDF 对象与输出预算仍覆盖全部外观

表单与外观选项使用文档的取消 Token；非法字段、畸形值、权限、签名认证失败、取消或预算失败都保持既有目标文件不变，源/目标别名被拒绝

此 API 覆盖原生混合事务；Windows JSON typed-rich 填充、旧任务 Callback 扩展、注释交换与内嵌或增量 FDF 数据属于独立工作流

更新记录与数组 · 富 FDF/XFDF 导入