MergeDocumentEx
Manipulación de documentos, formularios
Descripción
Une otro documento al documento seleccionado mientras aplica una política explícita a los nombres duplicados de campos de formulario de nivel superior
La comprobación previa de nombres duplicados termina antes de que se modifiquen 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 anexará 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 de campo de destino y el valor predeterminado al campo importado, lo que permite que los visores compatibles traten 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