MergeFileList

Dokumentmanipulation

Beskrivelse

Fletter alle filer på en navngiven filliste og gemmer det resulterende flettede dokument i den angivne fil. Brug funktionerne ClearFileList, FileListCount og AddToFileList til at opbygge den navngivne filliste. Fillisten skal indeholde mindst to filer, for at fletningen kan lykkes.

Dispositioner (bogmærker), formularfelter og annoteringer fra alle dokumenterne findes i det sammenflettede dokument.

Den almindelige fletningsmetode skifter mellem midlertidige outputfiler efter det første par inputfiler og undgår dermed en ekstra fuldstændig kopi af den voksende midlertidige PDF for hver efterfølgende inputfil. Det bevarer den eksisterende returværdi for antal og reducerer samtidig disk-I/O ved længere fillister

Syntaks

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

Parametre

ListName	Navnet på listen over filer, der skal flettes Stien og filnavnet til den fil, der skal oprettes og indeholde de flettede filer.
OutputFileName

Annullering og ressourcer

Fletningen rapporterer fremdrift under scanning af input og skrivning af objekter. Kald af Abort stopper handlingen, lukker aktive streams og fjerner ufuldstændigt output. Fletninger fra fillister åbner hver kilde til scanning og holder højst den første og den aktuelle kildelæser aktive under skrivning, så brugen af greb forbliver begrænset, efterhånden som listen vokser

Returværdier

	Antallet af dokumenter, der blev flettet. Hvis dette er mindre end det ønskede antal, bruges funktionen FileListItem til at finde den fil, der fik fletningsprocessen til at stoppe for tidligt