CollateDocumentsEx

頁面操作、文件組裝

描述

以各來源各自的頁面範圍清單（含反向範圍），把多份開啟中文件的頁面整理進所選文件

Function TPDFlib.CollateDocumentsEx(Const SourceDocumentIDs: Array Of Integer; Const RangeLists: WideString; GroupSize: Integer): Integer;

SourceDocumentIDs	開啟中來源文件的控制代碼。清單中不得出現所選文件。
RangeLists	每個來源一份頁面範圍清單，以 ; 分隔。空字串表示選取每個來源的所有頁面，空區段表示選取該來源的所有頁面。遞減範圍（如 3-1）會反轉來源，重複頁面按給定順序保留。
GroupSize	每輪從各來源附加的頁數。

0	參數無效、某範圍指向不存在的頁面、分段數與來源數不符，或複製失敗；所選文件保持不變。
1	頁面已整理附加到所選文件的結尾。

傳統的單面掃描流程是正面按順序掃、反面反向掃；傳入 ;3-1 這類範圍清單，一次呼叫就能還原閱讀順序。所有參數會在修改所選文件之前驗證，失敗的呼叫不會動到文件。

// Fronts 1,2,3 and backs scanned in reverse order
PDF.CollateDocumentsEx([Fronts, Backs], ';3-1', 1);