CapturePage

页面操作

描述

此函数会 "捕获" 一个页面。捕获后可将该页面绘制到其他页面上。这对于组合不同页面,或在另一页面上放置多个原始页面(拼版)很有用。页面捕获后会从文档中删除。如果希望页面保留在文档中,必须创建一个空白页面,然后将捕获的页面绘制到该空白页面上

此外,由于文档必须始终至少有一页,如果某页面是文档中唯一的页面,就无法捕获它。在这种情况下,必须先添加新的空白页面,才能捕获现有页面

不能使用 CapturePage 将页面从一个文档移动到另一个新文档,因此必须先将所需页面合并到单个文档中,再调用 CapturePage。CaptureID 只是隐藏页面的指针,因此无需释放内存

页面的 "媒体框" 用作捕获页面的边界矩形。当应改用页面的 "裁剪框" 时,可使用 CapturePage 函数

语法

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

参数

Page要捕获的页码,文档中的第一页为第 1 页

返回值

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