This function "captures" the specified page from a document originally opened with DAOpenFile. The captured page can then be drawn onto any other page using the DADrawCapturedPage function. This is useful for combining different pages or for placing more than one original page onto another page (imposition).
Once a page has been captured it is removed from the document. If you would like the page to remain in the document you must create a blank page and draw the captured page onto the blank page.
The "media box" for the page is used as the bounding rectangle for the capture page. The DACapturePageEx function can be used in cases where the "crop box" for the page should be used instead.
If a document has an open action set to the captured page the resulting file will not load correctly in Acrobat and other PDF viewers. The RemoveOpenAction function can be used to remove the open action but this cannot be done using the Direct Access functions.
function TDebenuPDFLibrary1811.DACapturePage(FileHandle, PageRef: Integer): Integer;
Function DebenuPDFLibrary1811.PDFLibrary::DACapturePage(FileHandle As Long,
PageRef As Long) As Long
int DPLDACapturePage(int InstanceID, int FileHandle, int PageRef)
|FileHandle||A handle returned by the DAOpenFile, DAOpenFileReadOnly or DAOpenFromStream functions|
|PageRef||A page reference returned by the DAFindPage or DANewPage functions|
|0||The specified FileHandle or PageRef were not valid|
|Non-zero||An ID that can be used with the DADrawCapturedPage function|