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 函式。 |