CapturePage

Manipulação de páginas

Descrição

Esta função "captura" uma página. Depois de capturada, a página pode ser desenhada noutras páginas. É útil para combinar páginas diferentes ou colocar mais do que uma página original noutra página (imposição). Depois de capturada, a página é removida do documento. Se pretender que permaneça no documento, tem de criar uma página em branco e desenhar nela a página capturada

Além disso, como um documento tem de conter sempre pelo menos uma página, não é possível capturar uma página se for a única do documento. Neste caso, tem de adicionar uma nova página em branco antes de capturar a página existente

Não pode utilizar CapturePage para mover páginas de um documento para outro documento novo, pelo que todas as páginas necessárias têm de ser intercaladas num único documento antes de chamar CapturePage. CaptureID é apenas um ponteiro para uma página oculta, portanto não é necessário libertar memória

A "media box" da página é utilizada como retângulo delimitador da página capturada. A função CapturePage pode ser utilizada quando se pretender utilizar a "crop box" da página

Sintaxe

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

Valores devolvidos