BeginPageUpdate

Seitenlayout

Beschreibung

Startet eine Transaktion für die gebündelte Zeichnung auf der aktuell ausgewählten Seite. Nachfolgende Zeichenaufrufe (Text, Pfade, Bilder, Annotationen) werden in einem einzigen Stapel gepuffert und beim entsprechenden Aufruf von EndPageUpdate in den Inhaltsstream der Seite geschrieben

Verwenden Sie dies beim Zusammensetzen einer komplexen Seite aus vielen kleinen Zeichenprimitiven, insbesondere beim erneuten Öffnen einer zuvor gespeicherten Seite zur Bearbeitung. Die Stapelverarbeitung vermeidet den Aufwand der Inhaltsstream-Serialisierung pro Aufruf und hält den resultierenden Seiteninhaltsstream kompakt und wohlgeformt

Syntax

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Rückgabewerte

0	Fehlgeschlagen — es ist kein Dokument geöffnet oder derzeit keine Seite ausgewählt
1	Die Transaktion für die Stapelzeichnung wurde gestartet.

Anmerkungen

Jeder Aufruf von BeginPageUpdate muss mit einem Aufruf von EndPageUpdate auf derselben Seite gepaart werden. Das Paar ist nicht zwingend erforderlich, wenn Inhalt zu einer soeben mit NewPage erstellten neuen Seite hinzugefügt wird; in diesem Fall befindet sich die Seite bereits im Zustand "zum Schreiben geöffnet". Das Paar ist erforderlich, wenn eine zuvor geschlossene Seite nach EndPage oder nach dem Laden des Dokuments erneut geöffnet und ihr Inhalt geändert wird.

Verschachtelte Aufrufe werden nicht unterstützt — rufen Sie EndPageUpdate auf, bevor Sie eine andere Seite zur Bearbeitung öffnen.

Beispiel

// Add a stamp on an existing page of a loaded document
PDF.LoadFromFile('contract.pdf', '');
PDF.SelectPage(1);
PDF.BeginPageUpdate;
  PDF.SetTextColor(0.8, 0, 0);
  PDF.SetFontSize(48);
  PDF.PrintText(150, 400, 'DRAFT');
PDF.EndPageUpdate;
PDF.SaveToFile('contract-stamped.pdf');

Siehe auch

EndPageUpdate, SelectPage, NewPage, EndPage