THotPDF.ImportLoadedFormFromFDF Method
把 FDF 文件中的字段值导入匹配的已加载字段,包括多选 choice 字段的数组
导入在嵌套图事务中执行,一旦异常逃出就回滚此前所有更新;既有兼容规则仍然跳过未知字段和被拒绝的值,而严格的 interchange 导入会把这些当作错误拒绝
声明
function ImportLoadedFormFromFDF(const AFileName: TFileName): Integer;
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
AFileName | 此操作使用的源或目标文件路径 |
返回值
返回被更新的字段数量
使用注意事项
- 在替换目标值和选择索引之前先验证 choice 数组;祖先默认值和兄弟字段保持不变
- 显式传入空数组会清除选择,即使某个选项的导出值为空也是如此
- 数组要求目标是多选的选择字段,且元素必须是直接字符串;未解析的引用、嵌套数组和非字符串元素都会被拒绝
- 保留文件 API 对缺失字段和被拒绝更新的既有跳过行为;其旧式空标量值同样会被跳过
- 当文本或 choice 外观需要变化时,在保存之前显式请求外观重新生成