ComposeNext

Seitenlayout, Paginierung, Form XObjects

Beschreibung

Komponiert ein zustandsbehaftetes dynamisches Fragment unter Verwendung der Standard-Layoutrichtlinie in einen Zielseitenslot und meldet die endgültige Platzierung

Syntax

Function TPDFlibDynamicComponentSession.ComposeNext(Page: Integer;
  Left, Top, Width, Height: Double;
  Out Placement: TPDFlibDynamicPagePlacement): Integer;

Parameter

`Page`	Vorhandene 1-basierte Zielseitennummer
`Left`, `Top`	Obere linke Zielposition in den aktuellen Dokumenteinheiten
`Width`, `Height`	Endliche positive Größe des Zielslots, die zugleich die natürliche Leinwandgröße wird
`Placement`	Ausgegebener Platzierungsdatensatz, der das übernommene Fragment beschreibt

Anmerkungen

Der Aufruf baut seine Optionen über CreateLayoutOptions(Width, Height) auf und leitet an ComposeNextLayout weiter, sodass er die dopReject-Überlaufbehandlung, die Ausrichtung dhaLeft und dvaTop, die Paginierung dppAllowSplit und keine Fließraum-Minima erbt

Das verwendete Rechteck muss in den Slot passen, denn die Standard-Überlaufrichtlinie lehnt ab, statt zu beschneiden oder zu skalieren

ComposeNextLayout für das vollständige Platzierungs-, Wiederholungs- und Transformationsverhalten

Beispiel

repeat
  Status := Session.ComposeNext(PageNumber, 36, 36, 540, 720,
    Placement);
  if Status = PDF_DYNAMIC_COMPONENT_MORE then
    PageNumber := PDF.NewPage;
until Status <> PDF_DYNAMIC_COMPONENT_MORE;

Rückgabewerte

`PDF_DYNAMIC_COMPONENT_ERROR`	Eingabe-, Callback-, Geometrie-, Überlauf- oder Platzierungsvalidierung fehlgeschlagen, ohne Zustand zu übernehmen
`PDF_DYNAMIC_COMPONENT_MORE`	Das Fragment wurde übernommen, und es verbleibt weiterer Inhalt
`PDF_DYNAMIC_COMPONENT_COMPLETE`	Das Fragment hat die Sitzung abgeschlossen, oder die Sitzung war bereits vollständig
`PDF_DYNAMIC_COMPONENT_RETRY`	Die Paginierungs- oder Fließraumrichtlinie hat den nicht übernommenen Versuch in einen anderen Slot verschoben

Siehe auch

ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount