MergeDocumentEx
Manipulowanie dokumentem, formularze
Opis
Dołącza inny dokument do wybranego dokumentu, stosując jawną zasadę do powielonych nazw pól formularza najwyższego poziomu
Kontrola wstępna powielonych nazw kończy się przed zmianą numerów obiektów, drzew stron lub tablic formularza, dlatego odrzucony dokument źródłowy pozostaje otwarty i można go ponownie użyć
Składnia
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;Parametry
| DocumentID | Identyfikator dokumentu dołączanego do wybranego dokumentu |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge lub dfsAutoNumber |
Strategie
| dfsReject | Odrzuca operację, gdy nazwa pola głównego dokumentu źródłowego już istnieje, i pozostawia oba dokumenty bez zmian |
|---|---|
| dfsMerge | Zachowuje wspólną nazwę pola i stosuje wartość oraz wartość domyślną pola docelowego do zaimportowanego pola, dzięki czemu zgodne przeglądarki mogą traktować widżety jako jedno pole logiczne |
| dfsAutoNumber | Zmienia nazwę każdego kolidującego źródłowego pola głównego, używając pierwszego dostępnego deterministycznego przyrostka, takiego jak _2 lub _3 |
Wartości zwracane
Zwraca 1 po pomyślnym scaleniu albo 0, gdy sprawdzanie poprawności lub scalanie nie powiedzie się
Powielenie odrzucone przez dfsReject ustawia LastErrorCode na 705
Uwagi
Pomyślne scalenie usuwa dokument źródłowy z kolekcji dokumentów, tak samo jak MergeDocument
Ze względów zgodności MergeDocument zachowuje dotychczasową obsługę powielonych pól