SplitDocumentToFiles
Manipulação de páginas, montagem de documentos
Descrição
Divide o documento selecionado num lote de ficheiros de saída com um número fixo de páginas, analisando a origem apenas uma vez
Sintaxe
Delphi
Function TPDFlib.SplitDocumentToFiles(Const FileNameTemplate: WideString; PagesPerFile: Integer): Integer;Parâmetros
| FileNameTemplate | Padrão do nome do ficheiro de saída. Um marcador de posição %p é substituído pelo número de base 1 do ficheiro de saída; sem marcador de posição, o número é inserido antes da extensão do ficheiro |
|---|---|
| PagesPerFile | Número de páginas por ficheiro de saída. Passe 1 para dividir o documento em ficheiros de uma página |
Valores devolvidos
| 0 | Argumentos inválidos, ou falha ao escrever um bloco |
|---|---|
| N | O número de ficheiros de saída escritos |
Observações
O documento selecionado é analisado uma única vez e todos os blocos são copiados do mesmo grafo de objetos em memória, pelo que dividir um documento grande é drasticamente mais rápido do que invocar ExtractFilePages num ciclo, o que volta a abrir e analisar o ficheiro de entrada para cada intervalo. O ficheiro final recebe as páginas restantes quando a contagem de páginas não é um múltiplo exato de PagesPerFile. O documento selecionado não é modificado
Exemplo
PDF.LoadFromFile('report.pdf', '');
// report.pdf has 5 pages: writes burst-1.pdf (2), burst-2.pdf (2), burst-3.pdf (1)
PDF.SplitDocumentToFiles('burst-%p.pdf', 2);