EndPageUpdate
ページレイアウト
説明
最近の BeginPageUpdate 呼び出しが開いたバッチ描画トランザクションを閉じ、バッファリングされた描画演算子を現在ページのコンテンツストリームにフラッシュします。BeginPageUpdate の各呼び出しは正確に 1 回の EndPageUpdate 呼び出しと対応させる必要があります
構文
Delphi
Function TPDFlib.EndPageUpdate: Integer;
ActiveX
Function PDFlib::EndPageUpdate() As Long
DLL
int DLEndPageUpdate(int InstanceID);
戻り値
| 0 | 失敗 — 文書が開かれていないか、選択したページで BeginPageUpdate トランザクションが現在アクティブではありません |
|---|---|
| 1 | トランザクションが閉じられ、バッファリングされたコンテンツがページにコミットされました |
備考
EndPageUpdate を対応する BeginPageUpdate なしで呼び出しても効果はなく、0 を返す。トランザクションを開いた後に EndPageUpdate を呼び出さないと、バッファリングされた描画演算子はコミットされないままとなり、ドキュメントの保存時に失われる
例
// Add a watermark on every page of an existing document
PDF.LoadFromFile('contract.pdf', '');
for I := 1 to PDF.GetPageCount do
begin
PDF.SelectPage(I);
PDF.BeginPageUpdate;
PDF.SetTextColor(0.85, 0.85, 0.85);
PDF.SetFontSize(72);
PDF.PrintText(100, 400, 'CONFIDENTIAL');
PDF.EndPageUpdate;
end;
PDF.SaveToFile('contract-confidential.pdf');関連項目
BeginPageUpdate、SelectPage、PageCount、EndPage