BeginPageUpdate

頁面版面

描述

在目前所選頁面開啟批次繪製交易。之後的繪圖呼叫（文字、路徑、影像、註解）會緩衝成單一批次，等到對應的 EndPageUpdate 呼叫時一次沖寫到頁面的內容串流。

用許多小型繪圖圖元組合複雜頁面時使用，尤其是重新開啟先前儲存的頁面來編輯時。批次處理避免每次呼叫的內容串流序列化開銷，讓產生的頁面內容串流保持精簡且格式正確。

語法

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

傳回值

0	Failed — no document is open or no page is currently selected.
1	批次繪製交易已開始。

備註

每次 BeginPageUpdate 都必須在同一頁配對一次 EndPageUpdate。對剛由 NewPage 建立的新頁面加入內容時，這對呼叫不是硬性要求——該頁已處於「開放寫入」狀態。重新開啟先前已關閉的頁面（呼叫過 EndPage 或載入文件之後）並修改其內容時，這對呼叫就是必要的。

不支援巢狀呼叫 — 開啟另一頁編輯前，請先呼叫 EndPageUpdate。

範例

// Add a stamp on an existing page of a loaded document
PDF.LoadFromFile('contract.pdf', '');
PDF.SelectPage(1);
PDF.BeginPageUpdate;
  PDF.SetTextColor(0.8, 0, 0);
  PDF.SetFontSize(48);
  PDF.PrintText(150, 400, 'DRAFT');
PDF.EndPageUpdate;
PDF.SaveToFile('contract-stamped.pdf');

另見

EndPageUpdate, SelectPage, NewPage, EndPage