MergeFileList
Dokumentin käsittely
Kuvaus
Yhdistää nimetyn tiedostoluettelon kaikki tiedostot ja tallentaa yhdistetyn asiakirjan annettuun tiedostoon. Muodosta nimetty tiedostoluettelo ClearFileList-, FileListCount- ja AddToFileList-funktioilla. Jotta yhdistäminen onnistuu, luettelossa on oltava vähintään kaksi tiedostoa
Kaikkien asiakirjojen outline-rakenteet (kirjanmerkit), lomakekentät ja merkinnät säilyvät yhdistetyssä asiakirjassa
Tavallinen yhdistämispolku vuorottelee väliaikaisia tulostiedostoja ensimmäisen syöteparin jälkeen, jolloin kasvavasta välituloksesta ei kopioida kokonaista kopiota jokaista seuraavaa syötettä varten. Näin palautettavien määrän toiminta pysyy ennallaan ja levyn I/O pienenee pidemmillä tiedostoluetteloilla
Syntaksi
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);
Parametrit
| ListName | Yhdistettävien tiedostojen luettelon nimi Luotavan tiedoston polku ja tiedostonimi, johon yhdistetyt tiedostot tallennetaan |
|---|---|
| OutputFileName |
Peruutus ja resurssit
Yhdistäminen ilmoittaa edistymisen syötteiden lukuvaiheessa ja objektien kirjoitusvaiheessa. Abort-kutsu pysäyttää toiminnon, sulkee avoimet virrat ja poistaa keskeneräisen tulosteen. Tiedostoluettelopohjaiset yhdistämiset avaavat jokaisen lähteen omaa skannausta varten ja pitävät kirjoituksen aikana aktiivisena enintään ensimmäisen ja nykyisen lähteen lukijat, joten kahvojen käyttö pysyy rajattuna luettelon kasvaessa
Paluuarvot
| Niiden asiakirjojen määrä, jotka yhdistettiin onnistuneesti. Jos luku on pienempi kuin tavoiteltu määrä, yhdistämisen ennenaikaisesti keskeyttäneen tiedoston voi selvittää FileListItem-funktiolla |