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
| 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 | El identificador del proceso de captura. Este identificador debe proporcionarse a la función DrawCapturedPage |