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
| Page | Numéro de page à capturer La première page du document est la page 1 |
|---|
Valeurs de retour
| 0 | La page indiquée n’existe pas ou constitue l’unique page du document |
|---|---|
| Non-zero | L'ID du processus de capture Cet ID doit être fourni à la fonction DrawCapturedPage |