MergeDocumentEx

文件操作、表單

描述

把另一份文件併入所選文件,並對重複的頂層表單欄位名稱套用明確策略

重名預檢在物件編號、頁面樹或表單陣列被更動之前完成,因此被拒的來源文件仍保持開啟、可以重用

語法

Delphi

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

參數

DocumentID要附加到所選文件的文件 ID
DuplicateFieldStrategydfsReject、dfsMerge 或 dfsAutoNumber

策略

dfsReject來源根欄位名稱已存在時拒絕操作,兩份文件保持不變
dfsMerge保留共用欄位名稱,並把目標欄位值與預設值套用到匯入的欄位,讓符合規範的檢視器把這些 widget 視為同一個邏輯欄位
dfsAutoNumber為每個衝突的來源根欄位重新命名,使用第一個可用的確定性字尾,例如 _2 或 _3

傳回值

10

合併成功後為 dfsReject;驗證或合併失敗時為 LastErrorCode被 705 拒收的重複項目會設定

備註

合併成功後會從文件集合中移除來源文件,行為與 MergeDocument 一致

MergeDocument 為相容性考量,保留舊有的重複欄位行為

另請參閱

MergeDocument, TPDFlibDuplicateFieldStrategy