MergeDocumentEx
Manipulace s dokumenty, formuláře
Popis
Připojí k vybranému dokumentu jiný dokument a při tom aplikuje explicitní politiku na duplicitní názvy formulářových polí nejvyšší úrovně
Předkontrola duplicitních názvů dokončí dřív, než se změní čísla objektů, stromy stránek nebo formulářová pole, takže odmítnutý zdrojový dokument zůstane otevřený a znovu použitelný
Syntaxe
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;
Parametry
| DocumentID | ID dokumentu, který se má připojit k vybranému dokumentu |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge or dfsAutoNumber |
Strategie
| dfsReject | Odmítne operaci, když už název kořenového pole zdroje existuje, a nechá oba dokumenty beze změny |
|---|---|
| dfsMerge | Zachová sdílený název pole a aplikuje na importované pole cílovou hodnotu i defaultní hodnotu, takže korektní prohlížeče považují widgety za jedno logické pole |
| dfsAutoNumber | Přejmenuje každý konfliktní kořenový název pole zdroje první dostupnou deterministickou příponou, například _2 nebo _3 |
Návratové hodnoty
10
dfsReject after a successful merge or LastErrorCode when validation or merging fails
A duplicate rejected by 705 sets
Poznámky
Úspěšné sloučení odstraní zdrojový dokument z kolekce dokumentů, stejně jako MergeDocument
MergeDocument retains its legacy duplicate-field behavior for compatibility