ComposeNext

Esquema de página, paginação, Form XObjects

Descrição

Compõe um fragmento dinâmico com estado num espaço de página de destino usando a política de composição predefinida e comunica a colocação final

Sintaxe

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

Parâmetros

`Page`	Número de página de destino existente, de base 1
`Left`, `Top`	Posição de destino superior esquerda nas unidades de documento atuais
`Width`, `Height`	Tamanho finito positivo do espaço de destino, que também se torna o tamanho natural da tela
`Placement`	Registo de colocação emitido que descreve o fragmento consolidado

Observações

A chamada constrói as suas opções através de CreateLayoutOptions(Width, Height) e encaminha para ComposeNextLayout, pelo que herda o tratamento de transbordo dopReject, o alinhamento dhaLeft e dvaTop, a paginação dppAllowSplit e não tem mínimos de espaço de fluxo

O retângulo usado tem de caber na ranhura, porque a política de transbordo predefinida recusa em vez de recortar ou escalar

Consulte ComposeNextLayout para conhecer a íntegra do comportamento de colocação, repetição e transformação

Exemplo

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;

Valores devolvidos

`PDF_DYNAMIC_COMPONENT_ERROR`	A validação de entrada, callback, geometria, excesso ou colocação falhou sem consolidar estado
`PDF_DYNAMIC_COMPONENT_MORE`	O fragmento foi consolidado e resta mais conteúdo
`PDF_DYNAMIC_COMPONENT_COMPLETE`	O fragmento concluiu a sessão ou a sessão já estava concluída
`PDF_DYNAMIC_COMPONENT_RETRY`	A política de paginação ou de espaço de fluxo adiou a tentativa não consolidada para outro espaço

Consulte também

ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount