CapturePageEx

頁面操作

描述

此函數會「擷取」頁面。頁面一經擷取，即可繪製到其他頁面上。適合用來合併不同頁面，或把多個原始頁面放到另一頁（拼版）。頁面一經擷取就會從文件中移除。若要讓頁面留在文件中，必須建立空白頁面，再把擷取的頁面繪製到該空白頁上。

此外，文件隨時必須至少有一頁，因此若某頁是文件中唯一的頁面，就無法擷取。此時必須先加入新的空白頁面，才能擷取既有頁面。

CapturePageEx 會把擷取的頁面從其原文件中移除；若要保留來源頁面或從另一個開啟的文件匯入，請使用 ImportPageAsFormXObject

頁面的「media box」會作為擷取頁面的外接矩形。若應改用頁面的「crop box」，可改用 CapturePageEx 函數。

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

int DLCapturePageEx(int InstanceID, int Page, int Options);

Page	要擷取的頁碼。文件的第一頁為第 1 頁
Options	0 = 使用頁面的媒體框作為邊界矩形 1 = 若頁面有裁切框則使用裁切框作為邊界矩形，否則使用媒體框 2 = 若頁面有出血框則使用出血框作為邊界矩形，否則使用裁切框 3 = 若頁面有修剪框則使用修剪框作為邊界矩形，否則使用裁切框 4 = 若頁面有美術框則使用美術框作為邊界矩形，否則使用裁切框

0	指定的頁面不存在，或是文件中唯一的頁面
Non-zero	擷取程序的 ID。此 ID 必須提供給 DrawCapturedPage 函式