MergeFileList
Dokumentum-manipuláció
Leírás
Egy megnevezett fájllista összes fájlját egyesíti, és az eredményül kapott dokumentumot a megadott fájlba menti. A megnevezett fájllista felépítéséhez használja a ClearFileList, FileListCount és AddToFileList függvényeket. A sikeres egyesítéshez legalább két fájlnak kell lennie a fájllistában
Az összes dokumentum könyvjelzői, űrlapmezői és megjegyzései jelen lesznek az egyesített dokumentumban
A szokásos összevonási útvonal az első bemeneti fájlpár után váltogatja az ideiglenes kimeneti fájlokat, így minden további bemenetnél elkerüli a növekvő köztes PDF további teljes másolását. Ez megőrzi a meglévő visszatérési darabszám viselkedését, miközben hosszabb fájllisták esetén csökkenti a lemez I/O terhelését
Szintaxis
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);
Paraméterek
| ListName | Az összevonandó fájlok listájának neve. A létrehozandó, összevont fájlokat tartalmazó fájl elérési útja és neve |
|---|---|
| OutputFileName |
Megszakítás és erőforrások
Az egyesítés a bemenetek vizsgálata és az objektumok írása közben előrehaladást jelez. Az Abort hívása leállítja a műveletet, lezárja az aktív adatfolyamokat és eltávolítja a hiányos kimenetet. A fájllista-egyesítések minden forrást a vizsgálatához nyitnak meg, és írás közben legfeljebb az első és az aktuális forrás olvasóját tartják aktívan, így a kezelőhasználat a lista növekedésével korlátos marad
Visszatérési értékek
| A sikeresen egyesített dokumentumok száma. Ha ez kisebb a tervezett számnál, a FileListItem függvénnyel keresse meg azt a fájlt, amely miatt az egyesítési folyamat idő előtt véget ért |