ComposeDeferredPageLayers

Seitenlayout, Vektorgrafik, Inhaltsströme

Beschreibung

Platziert jede vorgemerkte verzögerte Ebene auf ihrer Zielseite in stabil aufsteigender Z-Index-Reihenfolge

Syntax

Delphi

Function TPDFlib.ComposeDeferredPageLayers: Integer;

ActiveX

Function PDFlib::ComposeDeferredPageLayers() As Long

DLL

int DLComposeDeferredPageLayers(int InstanceID);

Rückgabewerte

Gibt die Anzahl der zusammengestellten Ebenen zurück oder 0, wenn keine Ebene in der Warteschlange steht, die Aufzeichnung noch aktiv ist, die ausgewählte Seite nicht die Zielseite ist, sich ihre Abmessungen geändert haben oder ein erfasstes Formular nicht verfügbar ist

Anmerkungen

Die Methode sortiert eingereihte Ebenen nach Z-Index und Aufzeichnungsreihenfolge

Negative Ebenen werden vor den ursprünglichen Inhaltsstreams der Seite in aufsteigender Reihenfolge eingefügt, während Null- und positive Ebenen nach den ursprünglichen Inhaltsstreams in aufsteigender Reihenfolge angehängt werden

Jede zusammengesetzte Ebene fügt einen Inhaltsstrom mit genau einer Form-XObject-Platzierung hinzu, sodass die Kompositionskosten unabhängig von der Anzahl der Zeichenoperationen innerhalb der Ebene bleiben

Die ausgewählte Schriftart, aktive Inhaltsebene, der Painter-Zustand und die Kerning-Einstellung werden nach der Zusammensetzung wiederhergestellt

Bei einer nicht erfüllten Vorbedingung bleibt die Warteschlange verfügbar, sodass der Aufrufer die Zielseite erneut auswählen kann; ein Fehler nach einer Seitenänderung leert hingegen die Warteschlange, um eine doppelte Platzierung zu verhindern

Beispiel

PDF.BeginDeferredPageLayer(-10);
DrawBackground(PDF);
PDF.EndDeferredPageLayer;

PDF.BeginDeferredPageLayer(10);
DrawForeground(PDF);
PDF.EndDeferredPageLayer;

if PDF.ComposeDeferredPageLayers<> 2 then
  HandleCompositionError;