CapturePageEx

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

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 Long

DLL

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 = Usar el media box de la página como rectángulo delimitador 1 = Usar el crop box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el media box 2 = Usar el bleed box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el crop box 3 = Usar el trim box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el crop box 4 = Usar el art box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el crop box

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 = Usar el media box de la página como rectángulo delimitador 1 = Usar el crop box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el media box 2 = Usar el bleed box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el crop box 3 = Usar el trim box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el crop box 4 = Usar el art box de la página como rectángulo delimitador si tiene uno; de lo contrario, usar el crop box

Valores devueltos

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