CollateDocumentsEx
Przetwarzanie stron, Składanie dokumentu
Opis
Układa strony z kilku otwartych dokumentów w wybranym dokumencie według osobnej listy zakresów stron dla każdego źródła, z obsługą zakresów odwróconych.
Składnia
Delphi
Function TPDFlib.CollateDocumentsEx(Const SourceDocumentIDs: Array Of Integer; Const RangeLists: WideString; GroupSize: Integer): Integer;Parametry
| SourceDocumentIDs | Uchwyty otwartych dokumentów źródłowych. Wybrany dokument nie może znajdować się na liście. |
|---|---|
| RangeLists | Po jednej liście zakresów stron na źródło, rozdzielone znakiem ;. Pusty ciąg wybiera wszystkie strony ze wszystkich źródeł, a pusty segment wszystkie strony danego źródła. Zakresy malejące, takie jak 3-1, odwracają źródło, a powtórzone strony są zachowywane w podanej kolejności. |
| GroupSize | Liczba stron dołączanych z każdego źródła w każdej rundzie. |
Wartości zwracane
| 0 | Nieprawidłowe argumenty, zakres odwołuje się do brakującej strony, liczba segmentów nie odpowiada liczbie źródeł albo kopiowanie nie powiodło się; wybrany dokument pozostaje bez zmian. |
|---|---|
| 1 | Strony zostały dołączone w ustalonej kolejności na końcu wybranego dokumentu. |
Uwagi
Klasyczny przepływ skanera jednostronnego skanuje strony przednie w kolejności, a tylne w kolejności odwrotnej; przekazanie list zakresów w stylu ;3-1 przywraca kolejność odczytu w jednym wywołaniu. Wszystkie argumenty są sprawdzane przed zmodyfikowaniem wybranego dokumentu, więc nieudane wywołanie pozostawia go bez zmian.
Przykład
// Fronts 1,2,3 and backs scanned in reverse order
PDF.CollateDocumentsEx([Fronts, Backs], ';3-1', 1);