CapturePage

Manipulación de páginas

Descripción

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

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 añadir una página en blanco nueva antes de capturar la página existente

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

El "cuadro de medios" de la página se utiliza como rectángulo delimitador de la página capturada. La función CapturePage puede utilizarse cuando deba 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-zeroID del proceso de captura. Este ID debe facilitarse a la función DrawCapturedPage