EndPageUpdate

页面布局

描述

关闭由最近一次 BeginPageUpdate 调用开启的批量绘制事务，并将缓冲的绘制运算符刷新到当前页面的内容流。每次 BeginPageUpdate 调用都必须恰好配对一次 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