CapturePage

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

CapturePage ne permet pas de déplacer des pages d’un document vers un nouveau document ; toutes les pages requises doivent donc être fusionnées avant son appel. CaptureID est seulement un pointeur vers une page masquée, aucune mémoire ne doit donc être libérée

La "media box" de la page sert de rectangle de délimitation pour la page capturée. La fonction CapturePage peut être utilisée lorsque la "crop box" de la page doit être employée à la place

Syntaxe

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Paramètres

PageNuméro de page à capturer La première page du document est la page 1

Valeurs de retour

0La page indiquée n’existe pas ou constitue l’unique page du document
Non-zeroL'ID du processus de capture Cet ID doit être fourni à la fonction DrawCapturedPage