MergeDocumentEx
Управление документом, формы
Описание
Присоединяет другой документ к выбранному, применяя явную политику к дублирующимся именам полей формы верхнего уровня
Предпроверка дублирующихся имён завершается до изменения номеров объектов, деревьев страниц и массивов форм, поэтому отклонённый документ-источник остаётся открытым и пригодным
Синтаксис
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;Параметры
| DocumentID | ID документа, дописываемого к выбранному |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge or dfsAutoNumber |
Стратегии
| dfsReject | Отклоняет операцию, если корневое имя поля источника уже существует, и оставляет оба документа без изменений |
|---|---|
| dfsMerge | Сохраняет общее имя поля и применяет к импортируемому полю значение и значение по умолчанию целевого, позволяя корректным просмотрщикам считать виджеты одним логическим полем |
| dfsAutoNumber | Renames each conflicting source root field with the first available deterministic suffix such as _2 or _3 |
Возвращаемые значения
10
dfsReject after a successful merge or LastErrorCode when validation or merging fails
A duplicate rejected by 705 sets
Примечания
Успешное слияние удаляет исходный документ из коллекции документов, как и MergeDocument
MergeDocument retains its legacy duplicate-field behavior for compatibility