Compose

Pagina-indeling, paginering, Form XObjects

Beschrijving

Abstracte methode van TPDFlibDynamicComponent die één fragment van de component in lokale coördinaten tekent en zijn gebruikte grenzen en voortzettingsstatus meldt

Syntaxis

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

Syntaxis

`Context.LibraryInstance`	Gekoppelde `TPDFlib`-instantie waarmee het fragment moet tekenen
`Context.PageNumber`	Doelpaginanummer, ook al selecteert de bibliotheek een geïsoleerde tijdelijke pagina terwijl de callback draait
`Context.CompositionIndex`	Nummer beginnend bij 1 dat het fragment krijgt wanneer het wordt vastgelegd
`Context.DestinationLeft`, `Context.DestinationTop`	Positie van de bestemmingssleuf, doorgegeven vanuit de compose-aanroep
`Context.AvailableWidth`, `Context.AvailableHeight`	Natuurlijke canvagrootte van het omliggende Form XObject

Resultaatrecord

`HasContent`	True wanneer het fragment zichtbare content heeft getekend
`HasMoreContent`	True wanneer de component nog een fragment kan produceren
`UsedWidth`, `UsedHeight`	Gebruikte rechthoek die op lokale coördinaat nul begint en alle zichtbare componentcontent moet omsluiten

Opmerkingen

Inhoudsresultaten vereisen eindige positieve UsedWidth- en UsedHeight-waarden binnen AvailableWidth en AvailableHeight

Een resultaat zonder inhoud is alleen geldig wanneer HasMoreContent False is en beide gebruikte dimensies nul zijn

De callback mag teken- en inhouds-API's gebruiken, maar mag geen documenten, pagina's of geneste tekencontainers wijzigen

De sessie valideert ComposeResult via ValidComposeResult voordat enige plaatsingsbeslissing wordt genomen

Nul teruggeven wijst de poging af zonder component- of bestemmingsstatus vast te leggen; geworpen exceptions propageren nadat de sessie de transiënte toestand heeft opgeruimd

Retourwaarden

`1`	Het fragmentresultaat wordt aangeboden voor validatie en plaatsing
`0`	De poging wordt geweigerd en er verandert geen component- of bestemmingsstatus

Zie ook

TPDFlibDynamicComponent, TPDFlibDynamicPageContext, TPDFlibDynamicPageResult, ValidComposeResult, ComposeNextLayout, CloneComponent