CollateDocumentsEx
Seitenbearbeitung, Dokumentzusammenstellung
Beschreibung
Ordnet Seiten aus mehreren geöffneten Dokumenten anhand einer Seitenbereichsliste pro Quelle in das ausgewählte Dokument ein, einschließlich umgekehrter Bereiche
Syntax
Delphi
Function TPDFlib.CollateDocumentsEx(Const SourceDocumentIDs: Array Of Integer; Const RangeLists: WideString; GroupSize: Integer): Integer;Parameter
| SourceDocumentIDs | Handles der geöffneten Quelldokumente. Das ausgewählte Dokument darf nicht in der Liste enthalten sein |
|---|---|
| RangeLists | Eine Seitenbereichsliste pro Quelle, getrennt durch ;. Eine leere Zeichenfolge wählt alle Seiten jeder Quelle aus, und ein leeres Segment wählt alle Seiten dieser Quelle aus. Absteigende Bereiche wie 3-1 kehren die Quelle um, und doppelte Seiten bleiben in der angegebenen Reihenfolge erhalten |
| GroupSize | Anzahl der pro Runde aus jeder Quelle angehängten Seiten |
Rückgabewerte
| 0 | Ungültige Argumente, ein Bereich verweist auf eine fehlende Seite, die Segmentanzahl stimmt nicht mit der Quellenanzahl überein oder der Kopiervorgang ist fehlgeschlagen; das ausgewählte Dokument bleibt unverändert |
|---|---|
| 1 | Die Seiten wurden sortiert an das Ende des ausgewählten Dokuments angehängt |
Anmerkungen
Der klassische Arbeitsablauf für einseitige Scanner scannt die Vorderseiten der Reihe nach und die Rückseiten in umgekehrter Reihenfolge; die Übergabe von Bereichslisten im Stil ;3-1 stellt die Lesereihenfolge in einem Aufruf wieder her. Alle Argumente werden validiert, bevor das ausgewählte Dokument geändert wird, sodass es nach fehlgeschlagenen Aufrufen unverändert bleibt
Beispiel
// Fronts 1,2,3 and backs scanned in reverse order
PDF.CollateDocumentsEx([Fronts, Backs], ';3-1', 1);