AttachComponent

Partes do documento, dados variáveis, edição de documentos

Descrição

Substitui os instantâneos inicial e atual de componente de uma TPDFlibDynamicComponentSession por clones novos de um componente de propriedade do chamador e limpa todo o estado de progresso

Sintaxe

Function TPDFlibDynamicComponentSession.AttachComponent(
  AComponent: TPDFlibDynamicComponent): Integer;

Parâmetros

`AComponent`	Componente de propriedade do chamador cujo `CloneComponent` fornece tanto o novo instantâneo inicial quanto o novo instantâneo atual

Observações

Ambos os clones são criados antes que qualquer instantâneo armazenado seja liberado, de modo que um CloneComponent que retorna Nil deixa o componente anterior, a contagem de composição, o sinalizador de conclusão e o estado de nova tentativa intactos Em caso de sucesso, a sessão libera seus instantâneos antigos, armazena o novo par e redefine

CompositionCount para zero, bem como Completed, KeepTogetherRetryPending, LastRetryReason e LastRequiredSlotHeight A sessão nunca assume a propriedade de

AComponent

AttachComponent; apenas os clones são armazenados, de modo que o chamador mantém e libera a instância passada de forma independente O construtor da sessão chama Nil, de modo que uma sessão criada com um componente

Exemplo

Replacement := TNumberedPagesComponent.Create(1, 5);
try
  if Session.AttachComponent(Replacement) = 1 then
    Status := Session.ComposeNext(PageNumber, 36, 36, 540, 720,
      Placement);
finally
  Replacement.Free;
end;

Valores retornados

`1`	Ambos os clones foram criados e confirmados como os novos instantâneos inicial e atual, com todo o estado de progresso limpo
`0`	`AComponent` é `Nil` ou uma das chamadas `CloneComponent` retornou `Nil`, e os instantâneos e o estado anteriores são preservados

Veja também

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout