MergeFileList
Χειρισμός εγγράφου
Περιγραφή
Συγχωνεύει όλα τα αρχεία μιας ονομασμένης λίστας αρχείων και αποθηκεύει το προκύπτον έγγραφο στο καθορισμένο αρχείο. Χρησιμοποιήστε τις συναρτήσεις ClearFileList, FileListCount και AddToFileList για κατασκευή της λίστας. Πρέπει να υπάρχουν δύο ή περισσότερα αρχεία στη λίστα για να πετύχει η συγχώνευση
Outlines (bookmarks), πεδία φόρμας και σχόλια από όλα τα έγγραφα θα υπάρχουν στο συγχωνευμένο έγγραφο
Η κανονική διαδρομή συγχώνευσης εναλλάσσει προσωρινά αρχεία εξόδου μετά το πρώτο ζεύγος αρχείων εισόδου, αποφεύγοντας ένα επιπλέον πλήρες αντίγραφο του αυξανόμενου ενδιάμεσου PDF σε κάθε επόμενη είσοδο. Έτσι διατηρείται η υπάρχουσα συμπεριφορά ως προς τον αριθμό επιστροφών και μειώνεται το I/O δίσκου σε μεγαλύτερες λίστες αρχείων
Σύνταξη
Delphi
Function TPDFlib.MergeFileList(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileList(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileList(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
Παράμετροι
| ListName | Το όνομα της λίστας αρχείων προς συγχώνευση Η διαδρομή και το όνομα του αρχείου προς δημιουργία που θα περιέχει τα συγχωνευμένα αρχεία |
|---|---|
| OutputFileName |
Ακύρωση και πόροι
Η συγχώνευση αναφέρει πρόοδο κατά τη σάρωση εισόδων και τη γραφή αντικειμένων. Κλήση Abort σταματά τη λειτουργία, κλείνει ενεργά streams και αφαιρεί ημιτελή έξοδο. Συγχωνεύσεις λίστας αρχείων ανοίγουν κάθε πηγή για τη σάρωσή της και κρατούν το πολύ τους readers πρώτης και τρέχουσας πηγής ενεργούς κατά τη γραφή, ώστε η χρήση handles να μένει οριοθετημένη όσο μεγαλώνει η λίστα.
Τιμές επιστροφής
| Ο αριθμός εγγράφων που συγχωνεύτηκαν επιτυχώς. Αν είναι μικρότερος από τον αναμενόμενο αριθμό, χρησιμοποιήστε τη συνάρτηση FileListItem για να εντοπίσετε το αρχείο που προκάλεσε πρόωρο τερματισμό της διαδικασίας συγχώνευσης. |