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

ListNameYhdistettä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