MergeFileListFast

Documentmanipulatie

Beschrijving

Vergelijkbaar met de functie MergeFileList, maar gebruikt een geavanceerder algoritme voor betere snelheid

Tijdens het samenvoegen wordt een nieuwe bestandenlijst aangemaakt die voor elk item in de opgegeven bestandenlijst het resultaat van het samenvoegproces bevat. De nieuwe bestandenlijst krijgt dezelfde naam als de originele lijst met het woord Result erachter. Heette de originele lijst bijvoorbeeld "MyFiles", dan heet de nieuwe lijst "MyFilesResult". Deze nieuwe lijst bevat geen bestandsnamen, maar een tekstbeschrijving van de status van elk bestand tijdens het samenvoegproces

Er moeten twee of meer bestanden in de bestandenlijst staan, anders lukt het samenvoegen niet

Formuliervelden, annotaties en outlines (bookmarks) uit alle documenten komen in het samengevoegde document terecht

Syntaxis

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

Parameters

ListName	De naam van de te gebruiken bestandenlijst. Alle bestanden in deze lijst worden samengevoegd
OutputFileName	Het pad en de bestandsnaam van het aan te maken uitvoerbestand. Dit bestand bevat alle bestanden uit de bestandenlijst

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

0	Het samenvoegproces kon niet worden voltooid. Gebruik de functie GetLastError om de oorzaak van de fout te achterhalen
Non-zero	Het aantal bestanden dat met succes is samengevoegd