MergeFileList
Przetwarzanie dokumentów
Opis
Scala wszystkie pliki z nazwanej listy plików i zapisuje wynikowy scalony dokument do wskazanego pliku. Do utworzenia nazwanej listy plików użyj funkcji ClearFileList, FileListCount i AddToFileList. Aby scalanie się powiodło, lista musi zawierać co najmniej dwa pliki
Konspekty (zakładki), pola formularzy i adnotacje ze wszystkich dokumentów będą obecne w scalonym dokumencie
Zwykła ścieżka scalania po pierwszej parze plików wejściowych używa naprzemiennie tymczasowych plików wyjściowych, unikając dodatkowej pełnej kopii rosnącego pośredniego pliku PDF dla każdego kolejnego wejścia. Zachowuje to dotychczasowe zwracanie liczby elementów, a jednocześnie ogranicza operacje dyskowe dla dłuższych list plików
Składnia
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);
Parametry
| ListName | Nazwa listy plików do scalenia Ścieżka i nazwa tworzonego pliku, który będzie zawierał scalone pliki |
|---|---|
| OutputFileName |
Anulowanie i zasoby
Scalanie zgłasza postęp podczas skanowania danych wejściowych i zapisywania obiektów. Wywołanie Abort zatrzymuje operację, zamyka aktywne strumienie i usuwa niekompletne dane wyjściowe. Przy scalaniu listy plików każde źródło jest otwierane na czas skanowania, a podczas zapisu aktywne pozostają najwyżej czytniki pierwszego i bieżącego źródła, dzięki czemu użycie uchwytów pozostaje ograniczone w miarę wzrostu listy
Wartości zwracane
| Liczba dokumentów pomyślnie scalonych ze sobą. Jeżeli jest mniejsza od zamierzonej liczby, użyj funkcji FileListItem, aby znaleźć plik, który spowodował przedwczesne zakończenie procesu scalania |