MergeDocumentEx
Dokumentbearbeitung, Formulare
Beschreibung
Fügt dem ausgewählten Dokument ein weiteres Dokument hinzu und wendet dabei eine explizite Richtlinie auf doppelte Formularfeldnamen der obersten Ebene an
Die Vorprüfung auf doppelte Namen wird abgeschlossen, bevor Objektnummern, Seitenbäume oder Formulararrays geändert werden; ein abgelehntes Quelldokument bleibt daher geöffnet und wiederverwendbar
Syntax
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;Parameter
| DocumentID | Die ID des Dokuments, das an das ausgewählte Dokument angehängt werden soll |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge oder dfsAutoNumber |
Strategien
| dfsReject | Lehnt den Vorgang ab, wenn ein Quell-Wurzelfeldname bereits vorhanden ist, und lässt beide Dokumente unverändert |
|---|---|
| dfsMerge | Erhält den gemeinsamen Feldnamen und wendet den Zielfeldwert sowie den Standardwert auf das importierte Feld an, sodass konforme Viewer die Widgets als ein logisches Feld behandeln können |
| dfsAutoNumber | Benennt jedes in Konflikt stehende Stammfeld der Quelle mit dem ersten verfügbaren deterministischen Suffix wie _2 oder _3 um |
Rückgabewerte
Gibt nach einer erfolgreichen Zusammenführung 1 oder bei fehlgeschlagener Validierung beziehungsweise Zusammenführung 0 zurück
Ein von dfsReject abgelehntes Duplikat setzt LastErrorCode auf 705
Anmerkungen
Bei einer erfolgreichen Zusammenführung wird das Quelldokument entsprechend MergeDocument aus der Dokumentsammlung entfernt
MergeDocument bewahrt aus Kompatibilitätsgründen sein bisheriges Verhalten bei doppelten Feldern