MergeDocumentEx
Manipulação de documentos, formulários
Descrição
Junta outro documento ao documento selecionado aplicando uma política explícita para nomes duplicados de campos de formulário de nível superior
O preflight de nomes duplicados termina antes que números de objeto, árvores de páginas ou arrays de formulário sejam alterados, de modo que um documento de origem rejeitado permanece aberto e reutilizável
Sintaxe
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;
Parâmetros
| DocumentID | O ID do documento a anexar ao documento selecionado |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge or dfsAutoNumber |
Estratégias
| dfsReject | Rejeita a operação quando um nome de campo raiz da origem já existe e deixa ambos os documentos inalterados |
|---|---|
| dfsMerge | Preserva o nome de campo compartilhado e aplica o valor e o valor padrão do campo alvo ao campo importado, permitindo que visualizadores conformes tratem os widgets como um único campo lógico |
| dfsAutoNumber | Renames each conflicting source root field with the first available deterministic suffix such as _2 or _3 |
Valores retornados
10
dfsReject after a successful merge or LastErrorCode when validation or merging fails
A duplicate rejected by 705 sets
Observações
Uma mesclagem bem-sucedida remove o documento de origem da coleção de documentos, como MergeDocument
MergeDocument retains its legacy duplicate-field behavior for compatibility