MergeDocumentEx
Manipulación de documentos, formularios
Descripción
Une otro documento al documento seleccionado aplicando una directiva explícita a los nombres duplicados de campos de formulario de nivel superior
La comprobación preliminar de nombres duplicados finaliza antes de modificar los números de objeto, los árboles de páginas o las matrices de formularios, por lo que un documento de origen rechazado permanece abierto y reutilizable
Sintaxis
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;Parámetros
| DocumentID | El ID del documento que se añadirá al documento seleccionado |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge o dfsAutoNumber |
Estrategias
| dfsReject | Rechaza la operación cuando ya existe un nombre de campo raíz de origen y deja ambos documentos sin cambios |
|---|---|
| dfsMerge | Conserva el nombre de campo compartido y aplica el valor del campo de destino y el valor predeterminado al campo importado, lo que permite a los visores conformes tratar los widgets como un único campo lógico |
| dfsAutoNumber | Cambia el nombre de cada campo raíz de origen en conflicto con el primer sufijo determinista disponible, como _2 o _3 |
Valores devueltos
Devuelve 1 después de una combinación correcta o 0 cuando falla la validación o la combinación
Un duplicado rechazado por dfsReject establece LastErrorCode en 705
Observaciones
Una combinación correcta elimina el documento de origen de la colección de documentos, de acuerdo con MergeDocument
MergeDocument conserva su comportamiento heredado de campos duplicados por compatibilidad