ReplacePageRanges

文件操作

描述

以從另一個已開啟文件匯入的頁面,取代所選文件中現有頁面的視覺內容與頁面層級呈現,同時保留目標頁面物件

語法

Delphi

Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;

參數

DocumentID已開啟來源文件的識別碼,必須不同於所選的目標文件
TargetStartPage所選目標文件中開始取代的頁碼(以 1 為起始)
RangeList來源頁面範圍運算式,例如 "1-3,5";無效字元或超出範圍的頁面會使整個呼叫失敗
Options0 會排序頁面並移除重複;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);

另請參閱

CopyPageRanges, DeletePages, InsertPages