CapturePageEx

Seitenmanipulation

Beschreibung

Diese Funktion "erfasst" eine Seite. Nachdem die Seite erfasst wurde, kann sie auf andere Seiten gezeichnet werden. Das ist nützlich, um verschiedene Seiten zu kombinieren oder mehr als eine Originalseite auf einer anderen Seite zu platzieren (Ausschießen). Nach dem Erfassen wird die Seite aus dem Dokument entfernt. Soll die Seite im Dokument bleiben, müssen Sie eine leere Seite anlegen und die erfasste Seite auf die leere Seite zeichnen

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

CapturePageEx entfernt die erfasste Seite aus ihrem aktuellen Dokument; verwenden Sie ImportPageAsFormXObject, um die Quellseite zu erhalten oder sie aus einem anderen offenen Dokument zu importieren

Die "Media Box" der Seite wird als umschließendes Rechteck der erfassten Seite verwendet. Die Funktion CapturePageEx kann in den Fällen verwendet werden, in denen stattdessen die "Crop Box" der Seite verwendet werden soll

Syntax

Delphi

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

ActiveX

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

DLL

int DLCapturePageEx(int InstanceID, int Page, int Options);

Parameter

Page	Die zu erfassende Seitennummer. Die erste Seite im Dokument ist Seite 1
Options	0 = Media Box der Seite als Begrenzungsrechteck verwenden 1 = Crop Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Media Box 2 = Bleed Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Crop Box 3 = Trim Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Crop Box 4 = Art Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Crop Box

Page

Die zu erfassende Seitennummer. Die erste Seite im Dokument ist Seite 1

Options

0 = Media Box der Seite als Begrenzungsrechteck verwenden 1 = Crop Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Media Box 2 = Bleed Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Crop Box 3 = Trim Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Crop Box 4 = Art Box der Seite als Begrenzungsrechteck verwenden, falls vorhanden, sonst die Crop Box

Rückgabewerte

0	Die angegebene Seite existiert nicht, oder sie ist die einzige Seite im Dokument
Non-zero	Die ID des Erfassungsvorgangs. Diese ID muss der Funktion DrawCapturedPage übergeben werden