DACapturePage
Funcionalidade de acesso direto, manipulação de páginas
Descrição
Esta função "captura" a página especificada de um documento originalmente aberto com DAOpenFile. A página capturada pode então ser desenhada em qualquer outra página com a função DADrawCapturedPage. É útil para combinar páginas diferentes ou colocar mais do que uma página original noutra página (imposição)
Depois de capturada, uma página é removida do documento. Para manter a página no documento, tem de criar uma página em branco e desenhar nela a página capturada
A "media box" da página é utilizada como retângulo delimitador da página capturada. A função DACapturePageEx pode ser utilizada quando se deva utilizar antes a "crop box" da página
Sintaxe
Delphi
Function TPDFlib.DACapturePage(FileHandle, PageRef: Integer): Integer;ActiveX
Function PDFlib::DACapturePage(FileHandle As Long, PageRef As Long) As LongDLL
int DLDACapturePage(int InstanceID, int FileHandle, int PageRef);Parâmetros
| FileHandle | Um identificador devolvido pelas funções DAOpenFile, DAOpenFileReadOnly ou DAOpenFromStream |
|---|---|
| PageRef | Uma referência de página devolvida pelas funções DAFindPage ou DANewPage |
Valores devolvidos
| 0 | O FileHandle ou PageRef especificado não era válido |
|---|---|
| Non-zero | Um ID que pode ser utilizado com a função DADrawCapturedPage |