MergeDocumentEx
Manipolazione dei documenti, moduli
Descrizione
Unisce un altro documento a quello selezionato applicando un criterio esplicito ai nomi duplicati dei campi modulo di primo livello
Il preflight dei nomi duplicati termina prima di modificare numeri oggetto, alberi pagine o array modulo, così un documento rifiutato resta aperto e riutilizzabile
Sintassi
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;Parametri
| DocumentID | L'ID del documento da aggiungere al documento selezionato |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge o dfsAutoNumber |
Strategie
| dfsReject | Rifiuta l'operazione se esiste già un campo radice con lo stesso nome e lascia invariati i documenti |
|---|---|
| dfsMerge | Conserva il nome condiviso e applica valore e valore predefinito al campo importato, consentendo ai visualizzatori di trattare i widget come un campo logico |
| dfsAutoNumber | Rinomina ogni campo radice sorgente in conflitto con il primo suffisso deterministico disponibile, come _2 o _3 |
Valori restituiti
Restituisce 1 dopo un'unione riuscita oppure 0 quando la convalida o l'unione non riesce
Un duplicato rifiutato da dfsReject imposta LastErrorCode su 705
Note
Un'unione riuscita rimuove il documento origine dalla raccolta, come MergeDocument
MergeDocument conserva il comportamento legacy dei campi duplicati per compatibilità