CollateDocumentsEx
Manipulação de páginas, Montagem de documentos
Descrição
Intercala páginas de vários documentos abertos no documento selecionado com uma lista de intervalos de páginas por origem, incluindo intervalos invertidos
Sintaxe
Delphi
Function TPDFlib.CollateDocumentsEx(Const SourceDocumentIDs: Array Of Integer; Const RangeLists: WideString; GroupSize: Integer): Integer;Parâmetros
| SourceDocumentIDs | Handles dos documentos de origem abertos. O documento selecionado não pode aparecer na lista. |
|---|---|
| RangeLists | Uma lista de intervalos de páginas por origem, separados por ;. Uma string vazia seleciona todas as páginas de todas as origens, e um segmento vazio seleciona todas as páginas daquela origem. Intervalos descendentes como 3-1 invertem a origem, e páginas duplicadas são mantidas na ordem dada. |
| GroupSize | Número de páginas anexadas de cada origem por rodada. |
Valores retornados
| 0 | Argumentos inválidos, um intervalo se refere a uma página inexistente, a contagem de segmentos não bate com a contagem da origem, ou a cópia falhou; o documento selecionado permanece inalterado. |
|---|---|
| 1 | As páginas foram agregadas ao final do documento selecionado. |
Observações
O fluxo clássico de scanner de face única varre as frentes em ordem e os versos em ordem inversa; passar listas de intervalos no estilo ;3-1 restaura a ordem de leitura em uma única chamada. Todos os argumentos são validados antes de o documento selecionado ser modificado, então chamadas que falham o deixam intocado.
Exemplo
// Fronts 1,2,3 and backs scanned in reverse order
PDF.CollateDocumentsEx([Fronts, Backs], ';3-1', 1);