CapturePage

Manipulación de páginas

Descripción

Esta función "captura" una página. Una vez capturada, se puede dibujar en otras páginas. Resulta útil para combinar páginas distintas o para colocar más de una página original en otra página (imposición). Una vez capturada, la página se elimina del documento. Si desea que permanezca en el documento, debe crear una página en blanco y dibujar en ella la página capturada

Además, como un documento debe tener al menos una página en todo momento, no es posible capturar una página si es la única del documento. En ese caso, debe agregar una página en blanco antes de poder capturar la página existente

No se puede usar CapturePage para mover páginas de un documento a otro documento nuevo, por lo que todas las páginas necesarias se deben combinar en un único documento antes de llamar a CapturePage El CaptureID es solo un puntero a una página oculta, por lo que no es necesario liberar memoria

El "cuadro multimedia" de la página se usa como rectángulo delimitador de la página capturada. La función CapturePage se puede usar cuando debe emplearse en su lugar el "cuadro de recorte" de la página

Sintaxis

Delphi

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

ActiveX

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

DLL

int DLCapturePage(int InstanceID, int Page);

Parámetros

PageEl número de página que se capturará. La primera página del documento es la página 1

Valores devueltos

0La página especificada no existe o es la única página del documento
Non-zeroEl identificador del proceso de captura. Este identificador debe proporcionarse a la función DrawCapturedPage