EndPageUpdate

Seitenlayout

Beschreibung

Schließt die durch den neuesten Aufruf von BeginPageUpdate geöffnete Stapelzeichentransaktion und schreibt die gepufferten Zeichenoperatoren in den Inhaltsstream der aktuellen Seite. Jeder Aufruf von BeginPageUpdate muss mit genau einem Aufruf von EndPageUpdate gepaart werden.

Syntax

Delphi

Function TPDFlib.EndPageUpdate: Integer;

ActiveX

Function PDFlib::EndPageUpdate() As Long

DLL

int DLEndPageUpdate(int InstanceID);

Rückgabewerte

0Fehlgeschlagen — es ist kein Dokument geöffnet oder auf der ausgewählten Seite ist derzeit keine Transaktion von BeginPageUpdate aktiv
1Die Transaktion wurde geschlossen und der gepufferte Inhalt auf die Seite übertragen.

Anmerkungen

Ein Aufruf von EndPageUpdate ohne entsprechendes BeginPageUpdate bleibt wirkungslos und gibt 0 zurück. Wird nach dem Öffnen einer Transaktion der Aufruf von EndPageUpdate vergessen, bleiben die gepufferten Zeichenoperatoren unbestätigt; beim Speichern des Dokuments gehen sie verloren

Beispiel

// 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');

Siehe auch

BeginPageUpdate, SelectPage, PageCount, EndPage