CapturePage

頁面操作

描述

此函式會「擷取」頁面。擷取後即可畫到其他頁面上,適合組合不同頁面,或把多個原始頁面放到同一頁(拼版)。頁面擷取後就會從文件移除;想讓頁面留在文件裡,必須先建立空白頁,再把擷取的頁面畫上去

另外,文件隨時至少要有一頁,所以文件唯一的頁面無法擷取。這種情況下必須先加入新的空白頁,才能擷取原有頁面

CapturePage 無法把頁面從一份文件搬到另一份新文件,因此呼叫 CapturePage 之前,必須先把所需頁面合併進單一文件。CaptureID 只是指向隱藏頁面的指標,不需要釋放記憶體。

擷取頁面的邊界矩形採用該頁的 "media box";若應改用 "crop box",請改用 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 函式。