MergeFileList

Documentmanipulatie

Beschrijving

Voegt alle bestanden in een benoemde bestandenlijst samen en slaat het samengevoegde document op in het opgegeven bestand. Gebruik de functies ClearFileList, FileListCount en AddToFileList om de benoemde bestandenlijst op te bouwen. De lijst moet minstens twee bestanden bevatten, anders lukt het samenvoegen niet

Outlines (bookmarks), formuliervelden en annotaties uit alle documenten komen in het samengevoegde document terecht

Het gewone samenvoegpad wisselt na het eerste paar invoerbestanden tijdelijke uitvoerbestanden af, zodat voor elke volgende invoer geen extra volledige kopie van de groeiende tussenliggende PDF nodig is. Hierdoor blijft het bestaande gedrag voor het aantal retourwaarden behouden en neemt de schijf-I/O bij langere bestandslijsten af.

Syntaxis

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);

Parameters

ListName	De naam van de lijst met samen te voegen bestanden Het pad en de bestandsnaam van het aan te maken bestand dat de samengevoegde bestanden zal bevatten
OutputFileName

Annulering en resources

De samenvoeging meldt voortgang tijdens het scannen van invoer en het wegschrijven van objecten. Een aanroep van Abort stopt de bewerking, sluit actieve streams en verwijdert onvolledige uitvoer. Bestandenlijst-samenvoegingen openen elke bron voor zijn scan en houden tijdens het schrijven ten hoogste de eerste en de huidige bronreaders actief, zodat het handle-gebruik begrensd blijft naarmate de lijst groeit

Retourwaarden

	Het aantal documenten dat met succes is samengevoegd. Is dit minder dan het beoogde aantal, gebruik dan de functie FileListItem om het bestand te vinden dat het samenvoegproces voortijdig heeft beëindigd