MergeDocumentEx
Manipulação de documentos, formulários
Descrição
Associa outro documento ao documento selecionado, aplicando uma política explícita aos nomes duplicados de campos de formulário de nível superior
A pré-verificação dos nomes duplicados termina antes da alteração dos números de objetos, árvores de páginas ou matrizes de formulários, pelo 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 ou dfsAutoNumber |
Estratégias
| dfsReject | Rejeita a operação quando já existe um nome de campo raiz de origem e deixa ambos os documentos inalterados |
|---|---|
| dfsMerge | Mantém o nome de campo partilhado e aplica o valor e o valor predefinido do campo de destino ao campo importado, permitindo que os visualizadores conformes tratem os widgets como um único campo lógico |
| dfsAutoNumber | Muda o nome de cada campo raiz de origem em conflito com o primeiro sufixo determinístico disponível, como _2 ou _3 |
Valores devolvidos
Devolve 1 após uma intercalação bem-sucedida ou 0 quando a validação ou intercalação falha
Um duplicado rejeitado por dfsReject define LastErrorCode como 705
Observações
Uma intercalação bem-sucedida remove o documento de origem da coleção de documentos, em conformidade com MergeDocument
MergeDocument mantém o comportamento antigo de campos duplicados por motivos de compatibilidade