MergeDocumentEx
文件操作、表單
描述
把另一份文件併入所選文件,並對重複的頂層表單欄位名稱套用明確策略
重名預檢在物件編號、頁面樹或表單陣列被更動之前完成,因此被拒的來源文件仍保持開啟、可以重用
語法
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;
參數
| DocumentID | 要附加到所選文件的文件 ID |
|---|---|
| DuplicateFieldStrategy | dfsReject、dfsMerge 或 dfsAutoNumber |
策略
| dfsReject | 來源根欄位名稱已存在時拒絕操作,兩份文件保持不變 |
|---|---|
| dfsMerge | 保留共用欄位名稱,並把目標欄位值與預設值套用到匯入的欄位,讓符合規範的檢視器把這些 widget 視為同一個邏輯欄位 |
| dfsAutoNumber | 為每個衝突的來源根欄位重新命名,使用第一個可用的確定性字尾,例如 _2 或 _3 |
傳回值
10
合併成功後為 dfsReject;驗證或合併失敗時為 LastErrorCode被 705 拒收的重複項目會設定
備註
合併成功後會從文件集合中移除來源文件,行為與 MergeDocument 一致
MergeDocument 為相容性考量,保留舊有的重複欄位行為