CapturePageEx
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, o que é útil para combinar páginas diferentes ou para colocar mais do que uma página original noutra página (imposição); depois de uma página ser capturada, é removida do documento; se quiser que a página permaneça no documento, tem de criar uma página em branco e desenhar a página capturada na página em brancoAlém disso, como um documento tem de ter 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 que a página existente possa ser capturadaCapturePageEx remove a página capturada do documento atual; use
ImportPageAsFormXObject para preservar a página de origem ou importá-la de outro documento abertoA "media box" da página é usada como retângulo delimitador da página capturada; a função CapturePageEx pode ser usada nos casos em que deve ser usada a "crop box" da página
Sintaxe
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 | O número da página a capturar; a primeira página do documento é a página 1 |
|---|---|
| Options | 0 = Usar a media box da página como retângulo delimitador 1 = Usar a crop box da página como retângulo delimitador se existir uma, caso contrário usar a media box 2 = Usar a bleed box da página como retângulo delimitador se existir uma, caso contrário usar a crop box 3 = Usar a trim box da página como retângulo delimitador se existir uma, caso contrário usar a crop box 4 = Usar a art box da página como retângulo delimitador se existir uma, caso contrário usar a crop box |
Valores devolvidos
| 0 | A página indicada não existe, ou é a única página do documento |
|---|---|
| Non-zero | O ID do processo de captura; este ID tem de ser fornecido à função DrawCapturedPage |