THPDFHeadlessDocument.ImportFormDataToFile
function ImportFormDataToFile(const FileName: string;
const Bytes: SysUtils.TBytes; Format: THPDFHeadlessFormDataFormat;
const TrueTypeFont: SysUtils.TBytes;
const AppearanceOptions: THPDFHeadlessTextAppearanceOptions;
const Options: THPDFHeadlessFormDataOptions): Integer;
解码全部提供的表单数据字节,把真实变更值与重新生成的控件外观应用到私有修订对象图,并原子发布独立增量 PDF
返回值统计变更的末端字段,radio 组按一个字段计;未变化的值保留且不计为变更
已加载文档保留全部原始与先前准备的值、字体与外观;输出在应用导入值之前先纳入这些准备好的变更
仅名称条目不改动字段(包括签名);为未知字段或不受支持的签名/pushbutton 字段提供值会产生类型化诊断
文本字段要求一个文本值,choice 字段接受标量文本或数组,按钮要求标量导出状态;既有 checkbox 与 radio 导出状态保留
TrueTypeFont 必须包含所需的全部文本与按钮字形;AppearanceOptions 经既有原生外观 setter 控制真实布局、Shaping、间距与控件外观
此入口只提供 regular 富字体槽位;要为导入富值提供真实 bold、italic 与 bold-italic 程序请用 ImportRichFormDataToFile
只读标志、必需字段约束、已认证的 DocMDP 与 FieldMDP、先前签名完整性以及 AES 表单填充权限在发布前强制执行
未变化的只读值允许幂等往返;变化的只读或锁定值会丢弃整个候选操作
源文件不能作为目标,包括物理别名;输出路径必须非空且不含 NUL
完整解码模型在 staging 前校验;后续任何失败、取消或预算耗尽都保留既有目标文件并删除未发布的私有文件
私有加密对象图在借用修订密钥之前必须保留精确的已认证源加密字典;不保留也不重放口令
非 nil 时 Token 必须与已加载文档一致;表单数据与文档限制约束解析、字段数量、嵌套、文本、生成外观与完整 PDF 输出