Compose

Seitenlayout, Paginierung, Form XObjects

Beschreibung

Abstrakte Methode von TPDFlibDynamicComponent, die ein Fragment der Komponente in lokalen Koordinaten zeichnet und ihre verwendeten Grenzen und ihren Fortsetzungszustand meldet

Syntax

Function TPDFlibDynamicComponent.Compose(
  Const Context: TPDFlibDynamicPageContext;
  Out ComposeResult: TPDFlibDynamicPageResult): Integer;
  Virtual; Abstract;

Parameter

`Context.LibraryInstance`	Angehängte `TPDFlib`-Instanz, über die das Fragment zeichnen soll
`Context.PageNumber`	Zielseitennummer, obwohl die Bibliothek während des Callbacks eine isolierte temporäre Seite auswählt
`Context.CompositionIndex`	1-basierte Nummer, die das Fragment bei der Übernahme erhält
`Context.DestinationLeft`, `Context.DestinationTop`	Vom Compose-Aufruf durchgereichte Position des Zielslots
`Context.AvailableWidth`, `Context.AvailableHeight`	Natürliche Leinwandgröße des umgebenden Form XObject

Ergebnisdatensatz

`HasContent`	True, wenn das Fragment sichtbaren Inhalt gezeichnet hat
`HasMoreContent`	True, wenn die Komponente ein weiteres Fragment erzeugen kann
`UsedWidth`, `UsedHeight`	Verwendetes Rechteck, das bei der lokalen Koordinate null beginnt und sämtlichen sichtbaren Komponenteninhalt begrenzen soll

Anmerkungen

Inhaltsergebnisse erfordern endliche positive Werte UsedWidth und UsedHeight innerhalb von AvailableWidth und AvailableHeight Ein Ergebnis ohne Inhalt ist nur gültig, wenn

Ein Ergebnis ohne Inhalt ist nur gültig, wenn HasMoreContent False ist und beide verwendeten Abmessungen null sind

Der Callback darf Zeichen- und Inhalts-APIs verwenden, darf aber keine Dokumente, Seiten oder verschachtelte Zeichencontainer ändern

Die Sitzung validiert ComposeResult über ValidComposeResult, bevor irgendeine Platzierungsentscheidung fällt

Null zurückzugeben lehnt den Versuch ab, ohne Komponenten- oder Zielzustand zu bestätigen; ausgelöste Ausnahmen pflanzen sich fort, nachdem die Sitzung den temporären Zustand aufgeräumt hat

Rückgabewerte

`1`	Das Fragmentergebnis wird zur Validierung und Platzierung vorgelegt
`0`	Der Versuch wird abgelehnt, und es ändert sich kein Komponenten- oder Zielzustand

Siehe auch

TPDFlibDynamicComponent, TPDFlibDynamicPageContext, TPDFlibDynamicPageResult, ValidComposeResult, ComposeNextLayout, CloneComponent