MergeFileListFast
Dokumentin käsittely
Kuvaus
Muistuttaa MergeFileList-funktiota, mutta käyttää nopeutta parantavaa edistynyttä algoritmia
Yhdistämisen aikana luodaan uusi tiedostoluettelo, joka sisältää jokaisen annetun luettelon kohteen yhdistämisen tuloksen. Uusi luettelo saa saman nimen kuin alkuperäinen, perään liitettynä sana Result. Jos alkuperäinen luettelo oli esimerkiksi nimeltään "MyFiles", uusi luettelo on nimeltään "MyFilesResult". Uusi luettelo ei sisällä tiedostonimiä vaan tekstimuotoisen kuvauksen kunkin tiedoston tilasta yhdistämisprosessin aikana
Jotta yhdistäminen onnistuu, tiedostoluettelossa on oltava vähintään kaksi tiedostoa
Kaikkien asiakirjojen lomakekentät, merkinnät ja outline-rakenteet (kirjanmerkit) säilyvät yhdistetyssä asiakirjassa
Syntaksi
Delphi
Function TPDFlib.MergeFileListFast(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileListFast(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileListFast(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
Parametrit
| ListName | Käytettävän tiedostoluettelon nimi. Kaikki luettelon tiedostot yhdistetään yhteen |
|---|---|
| OutputFileName | Luotavan tulostiedoston polku ja tiedostonimi. Tiedosto sisältää kaikki tiedostoluettelon tiedostot |
Cancellation and resources
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
| 0 | Yhdistämisprosessia ei voitu viimeistellä. Virheen syyn voi selvittää GetLastError-funktiolla |
|---|---|
| Non-zero | Onnistuneesti yhdistettyjen tiedostojen määrä |