ReplacePageRanges
文件操作
描述
以從另一個已開啟文件匯入的頁面,取代所選文件中現有頁面的視覺內容與頁面層級呈現,同時保留目標頁面物件
語法
Delphi
Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;參數
| DocumentID | 已開啟來源文件的識別碼,必須不同於所選的目標文件 |
|---|---|
| TargetStartPage | 所選目標文件中開始取代的頁碼(以 1 為起始) |
| RangeList | 來源頁面範圍運算式,例如 "1-3,5";無效字元或超出範圍的頁面會使整個呼叫失敗 |
| Options | 0 會排序頁面並移除重複;1 則保留來源順序並允許重複的頁碼 |
傳回值
| 0 | 驗證或取代失敗,目標頁面保持不變 |
|---|---|
| 1 | 要求的目標頁面已取代 |
備註
此作業會轉移 Contents、Resources、五個頁面邊界框、Rotate、Group、UserUnit 與 BoxColorInfo;目標頁面物件編號、附註、表單 Widget、書籤目的地與其他現有參照維持附加狀態;來源附註、表單欄位與大綱不會匯入;頁數保持不變,且所有來源範圍與目標容量都會在修改前完成驗證
範例
var SourceDoc: Integer;
SourceDoc := PDF.LoadFromFile('source.pdf', '');
PDF.SelectDocument(MainDoc);
// Replace page 2 of MainDoc with page 1 of source.pdf
PDF.ReplacePageRanges(SourceDoc, 2, '1', 0);