CapturePageEx

Manipulação de páginas

Descrição

Esta função "captura" uma página. Depois de capturada, a página pode ser desenhada em outras páginas. Isso é útil para combinar páginas diferentes ou para colocar mais de uma página original em outra página (imposição). Depois de capturada, a página é removida do documento. Se você quiser que a página permaneça no documento, é preciso criar uma página em branco e desenhar a página capturada nela

Além disso, como um documento deve ter pelo menos uma página em todos os momentos, não é possível capturar uma página se ela for a única do documento. Nesse caso, é preciso adicionar uma nova página em branco antes que a página existente possa ser capturada

CapturePageEx remove a página capturada do documento atual; use ImportPageAsFormXObject para preservar a página de origem ou importá-la de outro documento aberto

O "media box" da página é usado como retângulo delimitador da página capturada. A função CapturePageEx pode ser usada quando o "crop box" da página deve ser usado em vez disso

Sintaxe

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

PageO número da página a capturar. A primeira página do documento é a página 1
Options0 = Usa a media box da página como retângulo delimitador 1 = Usa a crop box da página como retângulo delimitador se ela tiver uma; caso contrário, usa a media box 2 = Usa a bleed box da página como retângulo delimitador se ela tiver uma; caso contrário, usa a crop box 3 = Usa a trim box da página como retângulo delimitador se ela tiver uma; caso contrário, usa a crop box 4 = Usa a art box da página como retângulo delimitador se ela tiver uma; caso contrário, usa a crop box

Valores retornados

0A página especificada não existe, ou é a única página do documento
Non-zeroO ID do processo de captura. Este ID deve ser fornecido à função DrawCapturedPage