THotPDF.ImportLoadedFormFromXFDF 方法

把 XML Forms Data Format (XFDF) 文件中的表单字段值导入已加载文档

导入对所有字段是原子的:后面某个更新被拒绝时,会回滚之前的值和已生成的外观;导入成功时,调用方自己包着的图事务会原样保留

多个 value 元素填充多选 choice 字段,不因换行拼接或拆分文本;受支持的选择会重建字段值与选择索引,不改祖先默认值或兄弟字段

没有 value 的 field 元素保持既有字段不变;一个空 value 会清空没有空导出选项的多选字段,或在该选项存在时选中它

数组值在改动目标字段前先校验;可见文本或 choice 外观需要变化时,请在保存前显式请求重新生成外观

精确的选项值在整个导入选择列表中优先,与选项顺序无关;只有未匹配上的 XFDF 文本才能走十六进制拼写的兼容回退,回退成功时保存的是实际匹配到的选项值

低层 HPDFXFDFImportFields 重载接受独立、已初始化的 THPDFXFDFArrayAccess 记录;其 setter 处理完整值列表后返回 true,否则单个值回退到标量 setter,多值被拒绝

原低层重载为既有集成保留旧行为(包括用 LF 拼接多个值);THotPDF 使用新的数组感知重载

语法

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

参数

AFileName: TFileName
要导入的 XFDF 数据的文件名

返回值

返回被更新的字段数量;文件缺失时返回零,文件 I/O 错误和被拒绝的字段更新可能抛出异常