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
| Page | El número de página que se capturará. La primera página del documento es la página 1 |
|---|
Valores devueltos
| 0 | La página especificada no existe o es la única página del documento |
|---|---|
| Non-zero | ID del proceso de captura. Este ID debe facilitarse a la función DrawCapturedPage |