ComposeNext

Sidelayout, paginering, Form XObjects

Beskrivelse

Komponerer ét statefuldt dynamisk fragment i en destinationssideslot med standardlayoutpolitikken og rapporterer den endelige placering

Syntaks

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

Parametre

`Page`	Eksisterende etbaseret destinationssidenummer
`Left`, `Top`	Øverste venstre destinationsposition i aktuelle dokumentenheder
`Width`, `Height`	Endelig positiv destinationsslotsstørrelse, som også bliver den naturlige lærredstørrelse
`Placement`	Udsendt placeringspost, der beskriver det bundne fragment

Bemærkninger

Kaldet bygger sine valgmuligheder gennem CreateLayoutOptions(Width, Height) og videresender til ComposeNextLayout, så det arver dopReject-håndtering af overløb, dhaLeft- og dvaTop-justering, dppAllowSplit-paginering og ingen flow-space-minimumsværdier

Det anvendte rektangel skal passe i pladsen, fordi standard-overløbspolitikken afviser frem for at klippe eller skalere

Se ComposeNextLayout for fuld placerings-, gentagelses- og transformationsadfærd

Eksempel

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ærdier

`PDF_DYNAMIC_COMPONENT_ERROR`	Input-, callback-, geometri-, overløbs- eller placeringsvalidering fejlede uden at binde tilstand
`PDF_DYNAMIC_COMPONENT_MORE`	Fragmentet blev bundet fast, og mere indhold er tilbage
`PDF_DYNAMIC_COMPONENT_COMPLETE`	Fragmentet fuldførte sessionen, eller sessionen var allerede fuldført
`PDF_DYNAMIC_COMPONENT_RETRY`	Paginerings- eller flow-space-politik udsatte det ubundne forsøg til en anden slot

Se også

ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount