EndPageUpdate

چیدمان صفحه

توضیحات

تراکنش رسم دسته‌ای که توسط آخرین فراخوانی BeginPageUpdate باز شده را می‌بندد و عملگرهای رسم بافرشده را به استریم محتوای صفحهٔ جاری تخلیه می‌کند. هر فراخوانی BeginPageUpdate باید دقیقاً با یک فراخوانی EndPageUpdate جفت شود

نحو

Delphi

Function TPDFlib.EndPageUpdate: Integer;

ActiveX

Function PDFlib::EndPageUpdate() As Long

DLL

int DLEndPageUpdate(int InstanceID);

مقادیر بازگشتی

0	ناموفق — هیچ سندی باز نیست یا در حال حاضر هیچ تراکنش BeginPageUpdate فعالی روی صفحهٔ انتخاب‌شده جریان ندارد
1	تراکنش بسته شد و محتوای bufferشده روی صفحه commit شد

ملاحظات

فراخوانی EndPageUpdate بدون BeginPageUpdate متناظر اثری ندارد و 0 برمی‌گرداند. فراموش کردن فراخوانی EndPageUpdate بعد از باز کردن تراکنش، عملگرهای رسم بافرشده را commit‌نشده رها می‌کند؛ هنگام ذخیرهٔ سند از دست می‌روند

مثال

// 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