MergeDocumentEx

文档操作、表单

说明

把另一个文档合并进所选文档,并对重复的顶层表单字段名应用显式策略

重复名称预检会在更改对象编号、页面树或表单数组之前完成,因此被拒绝的源文档会保持打开且可复用

语法

Delphi

Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;

参数

DocumentID要追加到所选文档中的文档 ID
DuplicateFieldStrategydfsReject、dfsMerge 或 dfsAutoNumber

策略

dfsReject当源根字段名称已存在时拒绝操作,并保持两个文档不变
dfsMerge保留共享字段名称,并将目标字段值和默认值应用于导入字段,使符合要求的查看器将这些控件视为一个逻辑字段
dfsAutoNumber使用第一个可用的确定性后缀(如 _2 或 _3)重命名每个冲突的源根字段

返回值

合并成功后返回 1,验证或合并失败时返回 0

被 dfsReject 拒绝的重复项会将 LastErrorCode 设为 705

备注

成功合并后会从文档集合中移除源文档,与 MergeDocument 的行为一致

MergeDocument 为兼容性保留其旧版重复字段行为

另请参阅

MergeDocument、TPDFlibDuplicateFieldStrategy