CapturePageEx

页面操作

描述

该函数“捕获”页面。页面一经捕获即可绘制到其他页面上。这适用于组合不同页面,或把多个原始页面放到另一个页面上(拼版)。页面一经捕获就会从文档中移除。若希望页面留在文档中,必须新建一个空白页面,并把捕获的页面绘制到空白页面上。

另外,由于文档必须始终至少有一个页面,如果该页面是文档中唯一的页面,则无法捕获。此时必须先添加一个新的空白页面,才能捕获现有页面。

CapturePageEx 会把捕获的页面从其当前文档中移除;若要保留源页面或从另一个打开的文档导入,请使用 ImportPageAsFormXObject

页面的“媒体框”用作被捕获页面的外接矩形。若应改用页面的“裁剪框”,可以使用 CapturePageEx 函数。

语法

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);

参数

Page要捕获的页码。文档中第一页为第 1 页
Options0 = 使用页面的媒体框作为外接矩形 1 = 使用页面的裁剪框作为外接矩形(若无则使用媒体框) 2 = 使用页面的出血框作为外接矩形(若无则使用裁剪框) 3 = 使用页面的裁切框作为外接矩形(若无则使用裁剪框) 4 = 使用页面的艺术框作为外接矩形(若无则使用裁剪框)

返回值

0指定的页面不存在,或它是文档中唯一的页面
Non-zero捕获过程的 ID。必须将该 ID 提供给 DrawCapturedPage 函数