CapturePageEx

Manipulation de pages

Description

Cette fonction "captures" une page, qui peut ensuite être tracée sur d’autres pages pour les combiner ou réaliser une imposition. La page capturée est retirée du document. Pour la conserver, créez une page vierge et tracez-y la page capturée

De plus, puisqu’un document doit toujours comporter au moins une page, il est impossible de capturer une page si elle est la seule du document. Dans ce cas, ajoutez une nouvelle page vierge avant de pouvoir capturer la page existante

CapturePageEx retire la page capturée de son document actuel ; utilisez ImportPageAsFormXObject pour préserver la page source ou l'importer depuis un autre document ouvert

La "media box" de la page est utilisée comme rectangle englobant de la page capturée. La fonction CapturePageEx peut être utilisée dans les cas où la "crop box" de la page doit être utilisée à la place

Syntaxe

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);

Paramètres

Page	Le numéro de la page à capturer. La première page du document est la page 1
Options	0 = Utiliser le media box de la page comme rectangle englobant 1 = Utiliser le crop box de la page comme rectangle englobant s'il en possède un, sinon utiliser le media box 2 = Utiliser le bleed box de la page comme rectangle englobant s'il en possède un, sinon utiliser le crop box 3 = Utiliser le trim box de la page comme rectangle englobant s'il en possède un, sinon utiliser le crop box 4 = Utiliser le art box de la page comme rectangle englobant s'il en possède un, sinon utiliser le crop box

Page

Le numéro de la page à capturer. La première page du document est la page 1

Options

0 = Utiliser le media box de la page comme rectangle englobant 1 = Utiliser le crop box de la page comme rectangle englobant s'il en possède un, sinon utiliser le media box 2 = Utiliser le bleed box de la page comme rectangle englobant s'il en possède un, sinon utiliser le crop box 3 = Utiliser le trim box de la page comme rectangle englobant s'il en possède un, sinon utiliser le crop box 4 = Utiliser le art box de la page comme rectangle englobant s'il en possède un, sinon utiliser le crop box

Valeurs de retour

0	La page indiquée n'existe pas, ou c'est la seule page du document
Non-zero	L'identifiant du processus de capture. Cet identifiant doit être fourni à la fonction DrawCapturedPage