MergeDocumentEx
文档操作、表单
说明
把另一个文档合并进所选文档,并对重复的顶层表单字段名应用显式策略
重复名称预检会在更改对象编号、页面树或表单数组之前完成,因此被拒绝的源文档会保持打开且可复用
语法
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;
参数
| DocumentID | 要追加到所选文档中的文档 ID |
|---|---|
| DuplicateFieldStrategy | dfsReject、dfsMerge 或 dfsAutoNumber |
策略
| dfsReject | 当源根字段名称已存在时拒绝操作,并保持两个文档不变 |
|---|---|
| dfsMerge | 保留共享字段名称,并将目标字段值和默认值应用于导入字段,使符合要求的查看器将这些控件视为一个逻辑字段 |
| dfsAutoNumber | 使用第一个可用的确定性后缀(如 _2 或 _3)重命名每个冲突的源根字段 |
返回值
合并成功后返回 1,验证或合并失败时返回 0
被 dfsReject 拒绝的重复项会将 LastErrorCode 设为 705
备注
成功合并后会从文档集合中移除源文档,与 MergeDocument 的行为一致
MergeDocument 为兼容性保留其旧版重复字段行为