ComposeNext

Sidlayout, sidbrytning, Form XObjects

Beskrivning

Komponerar ett tillståndsbärande dynamiskt fragment i en målsidesplats med standardlayoutpolicyn och rapporterar den slutliga placeringen

Syntax

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

Parametrar

`Page`	Befintligt ettbaserat målsidnummer
`Left`, `Top`	Övre vänstra målposition i aktuella dokumentenheter
`Width`, `Height`	Ändlig positiv målplatsstorlek som också blir den naturliga ritytestorleken
`Placement`	Utskickad placeringspost som beskriver det bekräftade fragmentet

Anmärkningar

Anropet bygger sina alternativ via CreateLayoutOptions(Width, Height) och vidarebefordrar till ComposeNextLayout, så det ärver överskottshanteringen dopReject, justeringarna dhaLeft och dvaTop, sidbrytningen dppAllowSplit och inga minimigränser för flödesutrymme

Den använda rektangeln måste rymmas i platsen, eftersom standardprincipen för överskott avvisar i stället för att klippa eller skala Se

ComposeNextLayout för det fullständiga placerings-, återförsöks- och transformeringsbeteendet

Exempel

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;

Returvärden

`PDF_DYNAMIC_COMPONENT_ERROR`	Indata, callback, geometri, överskott eller placeringsvalidering misslyckades utan att något tillstånd bekräftades
`PDF_DYNAMIC_COMPONENT_MORE`	Fragmentet bekräftades och mer innehåll återstår
`PDF_DYNAMIC_COMPONENT_COMPLETE`	Fragmentet fullbordade sessionen, eller sessionen var redan fullbordad
`PDF_DYNAMIC_COMPONENT_RETRY`	Sidbrytnings- eller flödesutrymmesprincipen sköt det obekräftade försöket till en annan plats

Se även

ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount