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