Compose

Diseño de página, paginación, Form XObjects

Descripción

Método abstracto de TPDFlibDynamicComponent que dibuja un fragmento del componente en coordenadas locales e informa de sus límites usados y su estado de continuación

Sintaxis

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

Parámetros

`Context.LibraryInstance`	Instancia de `TPDFlib` adjunta a través de la cual el fragmento debe dibujar
`Context.PageNumber`	Número de página de destino, aunque la biblioteca selecciona una página temporal aislada mientras se ejecuta la retrollamada
`Context.CompositionIndex`	Número basado en 1 que el fragmento recibe cuando se confirma
`Context.DestinationLeft`, `Context.DestinationTop`	Posición de la ranura de destino transferida desde la llamada de composición
`Context.AvailableWidth`, `Context.AvailableHeight`	Tamaño del lienzo natural del Form XObject circundante

Registro de resultado

`HasContent`	True cuando el fragmento dibujó contenido visible
`HasMoreContent`	True cuando el componente puede producir otro fragmento
`UsedWidth`, `UsedHeight`	Rectángulo usado que comienza en la coordenada local cero y debe acotar todo el contenido visible del componente

Observaciones

Los resultados con contenido requieren valores UsedWidth y UsedHeight finitos y positivos dentro de AvailableWidth y AvailableHeight Un resultado sin contenido solo es válido cuando

Un resultado sin contenido solo es válido cuando HasMoreContent es False y ambas dimensiones usadas son cero

La devolución de llamada puede usar las API de dibujo y de contenido pero no debe cambiar documentos, páginas ni contenedores de dibujo anidados

La sesión valida ComposeResult mediante ValidComposeResult antes de tomar cualquier decisión de colocación

Devolver cero rechaza el intento sin confirmar el estado del componente ni del destino; las excepciones lanzadas se propagan después de que la sesión haya limpiado el estado temporal

Valores devueltos

`1`	El resultado del fragmento se ofrece para validación y colocación
`0`	El intento se rechaza y no cambia ningún estado del componente ni del destino

Véase también

TPDFlibDynamicComponent, TPDFlibDynamicPageContext, TPDFlibDynamicPageResult, ValidComposeResult, ComposeNextLayout, CloneComponent