AttachComponent

Dokumentdele, variabeldata, dokumentredigering

Beskrivelse

Erstatter det første og det aktuelle komponentsnapshot i en TPDFlibDynamicComponentSession med friske kloner af en kalder-ejet komponent og rydder al fremdriftstilstand

Syntaks

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

Parametre

`AComponent`	Kalder-ejet komponent, hvis `CloneComponent` leverer både det nye første og det nye aktuelle snapshot

Bemærkninger

Begge kloner oprettes, før et gemt snapshot frigives, så en CloneComponent, der returnerer Nil, lader den forrige komponent, kompositionstælleren, fuldførelsesflagget og gentagelsestilstanden urørt Ved succes frigiver sessionen sine gamle snapshots, gemmer det nye par og nulstiller

CompositionCount til nul samt Completed, KeepTogetherRetryPending, LastRetryReason og LastRequiredSlotHeight Sessionen tager aldrig ejerskab til

AComponent

AttachComponent; kun klonerne gemmes, så kalderen beholder og frigiver den sendte instans uafhængigt Sessionskonstruktoren kalder Nil, så en session oprettet med en

Eksempel

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;

Returværdier

`1`	Begge kloner blev oprettet og bundet fast som det nye første og aktuelle snapshot med al fremdriftstilstand ryddet
`0`	`AComponent` er `Nil`, eller et af `CloneComponent`-kaldene returnerede `Nil`, og de forrige snapshots og tilstanden bevares

Se også

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout