Compose

Sidelayout, paginering, Form XObjects

Beskrivelse

Abstrakt metode i TPDFlibDynamicComponent, der tegner ét fragment af komponenten i lokale koordinater og rapporterer dets brugte grænser og fortsættelsestilstand

Syntaks

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

Parametre

`Context.LibraryInstance`	Tilsluttet `TPDFlib`-instans, som fragmentet skal tegne gennem
`Context.PageNumber`	Destinationssidenummer, selv om biblioteket vælger en isoleret midlertidig side, mens callback'en kører
`Context.CompositionIndex`	Etbaseret nummer, som fragmentet modtager, når det bindes fast
`Context.DestinationLeft`, `Context.DestinationTop`	Destinationsslotsposition sendt videre fra komponeringskaldet
`Context.AvailableWidth`, `Context.AvailableHeight`	Naturlig lærredstørrelse for den omgivende Form XObject

Resultatpost

`HasContent`	True, når fragmentet tegnede synligt indhold
`HasMoreContent`	True, når komponenten kan frembringe endnu et fragment
`UsedWidth`, `UsedHeight`	Brugt rektangel, der starter ved lokal koordinat nul og skal afgrænse alt synligt komponentindhold

Bemærkninger

Resultater med indhold kræver endelige positive UsedWidth- og UsedHeight-værdier inden for AvailableWidth og AvailableHeight

Et resultat uden indhold er kun gyldigt, når HasMoreContent er False, og begge anvendte dimensioner er nul

Callback'en må bruge tegne- og indholds-API'er, men må ikke ændre dokumenter, sider eller indlejrede tegnebeholdere

Sessionen validerer ComposeResult gennem ValidComposeResult, før nogen placeringsbeslutning træffes

Nul som returværdi afviser forsøget uden at committe komponent- eller destinationsstat; udløste undtagelser udbreder sig, efter sessionen har ryddet flygtig tilstand

Returværdier

`1`	Fragmentresultatet tilbydes til validering og placering
`0`	Forsøget afvises, og ingen komponent- eller destinationstilstand ændres

Se også

TPDFlibDynamicComponent, TPDFlibDynamicPageContext, TPDFlibDynamicPageResult, ValidComposeResult, ComposeNextLayout, CloneComponent