PDFium Delphi Component Docs

InsertObjectAtIndex Methode

Komponente: TPdf  ·  Unit: PDFium
Fügt ein Seitenobjekt an einer gewählten Position der Zeichenreihenfolge ein, statt es oben anzuhängen.

Syntax

procedure InsertObjectAtIndex(StackIndex: Integer; PageObj: Pointer);

StackIndexInteger. Nullbasierte Position im Content-Stream, an der das Objekt platziert wird. Objekte an oder nach dieser Position rücken um eins nach oben.
PageObjPointer. Handle eines erstellten, aber noch nicht eingefügten Seitenobjekts, etwa das Handle, das ObjectHandle für ein mit RemoveObject abgelöstes Objekt zurückgibt.

Description

Seitenobjekte zeichnen in Content-Stream-Reihenfolge, daher gewinnt das zuletzt gezeichnete Objekt, wo sich Objekte überlappen. Anhängen legt neuen Inhalt immer obenauf; diese Methode platziert ihn in beliebiger Tiefe – genau das, was ein Aufrufer braucht, um ein Wasserzeichen unter vorhandenen Text zu schieben oder ein entferntes und erneut hinzugefügtes Objekt neu zu stapeln

Die Seite übernimmt den Besitz des Objekts. Das Übergeben von nil wird ignoriert, ebenso ein Aufruf bei einem PDFium-Build, der den zugrunde liegenden Einstiegspunkt nicht exportiert; daher ist die Methode bedenkenlos bedingungslos aufrufbar

Die zwischengespeicherte Textseite wird verworfen und die Seite als geändert markiert. Rufen Sie vor dem Speichern UpdatePage auf, damit der bearbeitete Content-Stream neu erzeugt wird

See Also

RemoveObject, ObjectHandle, ObjectCount, UpdatePage