MergeFileList
Manipulação de documento
Descrição
Mescla todos os arquivos de uma lista de arquivos nomeada e grava o documento mesclado resultante no arquivo especificado. Use as funções ClearFileList, FileListCount e AddToFileList para construir a lista de arquivos nomeada. Deve haver dois ou mais arquivos na lista para que a mesclagem tenha êxito
Marcadores (outlines), campos de formulário e anotações de todos os documentos estarão presentes no documento mesclado
O caminho de mesclagem comum alterna arquivos de saída temporários após o primeiro par de arquivos de entrada, evitando uma cópia integral extra do PDF intermediário em crescimento para cada entrada subsequente. Isso mantém o comportamento existente de contagem de retorno enquanto reduz a E/S de disco em listas de arquivos mais longas
Sintaxe
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);
Parâmetros
| ListName | O nome da lista de arquivos a mesclar. O caminho e o nome do arquivo a criar, que conterá os arquivos mesclados. |
|---|---|
| OutputFileName |
Cancelamento e recursos
A mesclagem reporta o progresso durante a varredura das entradas e a gravação dos objetos. Chamar Abort interrompe a operação, fecha os streams ativos e remove a saída incompleta. Mesclagens por lista de arquivos abrem cada origem para a varredura e mantêm ativos, no máximo, os readers da primeira e da origem atual durante a gravação, de modo que o uso de handles permaneça limitado conforme a lista cresce.
Valores retornados
| O número de documentos mesclados com sucesso. Se for menor que o esperado, use a função FileListItem para encontrar o arquivo que fez o processo de mesclagem terminar antes da hora. |