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

ListNameNazwa 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