CapturePage
Manipulação de páginas
Descrição
Esta função "captura" uma página. Depois que a página é capturada, ela pode ser desenhada em outras páginas. Isso é útil para combinar páginas diferentes ou para colocar mais de uma página original sobre outra página (imposição). Depois que uma página é capturada, ela é 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 sobre ela
Além disso, como um documento precisa ter pelo menos uma página o tempo todo, 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
Não é possível usar CapturePage para mover páginas de um documento para outro, de modo que todas as páginas necessárias devem ser mescladas em um único documento antes de chamar CapturePage. O CaptureID é apenas um ponteiro para uma página oculta e portanto não precisa ser liberado
O "media box" da página é usado como retângulo delimitador da página capturada. A função CapturePage pode ser usada nos casos em que o "crop box" da página deva ser usado em seu lugar
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
| Page | O número da página a capturar. A primeira página do documento é a página 1. |
|---|
Valores retornados
| 0 | A página informada não existe, ou é a única página do documento |
|---|---|
| Non-zero | O ID do processo de captura. Este ID deve ser fornecido à função DrawCapturedPage. |