CapturePageEx
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
CapturePageEx elimina la página capturada de su documento actual; use ImportPageAsFormXObject para conservar la página de origen o importarla desde otro documento abierto
La "media box" de la página se usa como rectángulo delimitador de la página capturada. La función CapturePageEx puede usarse en los casos en que deba usarse la "crop box" de la página en su lugar
Sintaxis
Delphi
Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;ActiveX
Function PDFlib::CapturePageEx(Page As Long, Options As Long) As LongDLL
int DLCapturePageEx(int InstanceID, int Page, int Options);Parámetros
| Page | El número de la página que se va a capturar. La primera página del documento es la página 1 |
|---|---|
| Options | 0 = Usa el media box de la página como rectángulo delimitador 1 = Usa el crop box de la página como rectángulo delimitador si lo tiene; en caso contrario usa el media box 2 = Usa el bleed box de la página como rectángulo delimitador si lo tiene; en caso contrario usa el crop box 3 = Usa el trim box de la página como rectángulo delimitador si lo tiene; en caso contrario usa el crop box 4 = Usa el art box de la página como rectángulo delimitador si lo tiene; en caso contrario usa el crop box |
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 suministrarse a la función DrawCapturedPage |