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 函数 |