ComposeNext

Rozvržení stránek, stránkování, Form XObjects

Popis

Komponuje jeden stavový dynamický fragment do slotu cílové stránky podle výchozí politiky rozvržení a ohlásí konečné umístění

Syntaxe

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

Parametry

`Page`	Existující číslo cílové stránky počítané od 1
`Left`, `Top`	Cílová pozice levého horního rohu v aktuálních jednotkách dokumentu
`Width`, `Height`	Konečná kladná velikost cílového slotu, která se zároveň stane přirozenou velikostí plátna
`Placement`	Vyslaný záznam umístění popisující potvrzený fragment

Poznámky

Volání staví své volby přes CreateLayoutOptions(Width, Height) a předává do ComposeNextLayout, takže dědí zpracování přetečení dopReject, zarovnání dhaLeft a dvaTop, stránkování dppAllowSplit a žádná minima prostoru toku

Použitý obdélník se musí vejít do slotu, protože výchozí politika přetečení odmítá, namísto ořezu nebo škálování

Kompletní chování umístění, opakování a transformace viz ComposeNextLayout

Příklad

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;

Návratové hodnoty

`PDF_DYNAMIC_COMPONENT_ERROR`	Validace vstupu, zpětného volání, geometrie, přetečení či umístění selhala bez potvrzení stavu
`PDF_DYNAMIC_COMPONENT_MORE`	Fragment byl potvrzen a zbývá další obsah
`PDF_DYNAMIC_COMPONENT_COMPLETE`	Fragment dokončil relaci, nebo už relace byla dokončena
`PDF_DYNAMIC_COMPONENT_RETRY`	Politika stránkování či prostoru toku odkládá nepotvrzený pokus do jiného slotu

Viz také

ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount