AttachComponent

Dokumentdelar, variabel data, dokumentredigering

Beskrivning

Ersätter den initiala och aktuella komponentögonblicksbilden för en TPDFlibDynamicComponentSession med färska kloner av en komponent som ägs av anroparen och rensar allt förloppstillstånd

Syntax

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

Parametrar

`AComponent`	Komponent ägd av anroparen vars `CloneComponent` levererar både den nya initiala och den nya aktuella ögonblicksbilden

Anmärkningar

Båda klonerna skapas innan någon lagrad ögonblicksbild frigörs, så en CloneComponent som returnerar Nil lämnar den tidigare komponenten, kompositionsantalet, slutförandeflaggan och återförsökstillståndet orörda Vid lyckat resultat frigör sessionen sina gamla ögonblicksbilder, lagrar det nya paret och återställer

CompositionCount till noll samt Completed, KeepTogetherRetryPending, LastRetryReason och LastRequiredSlotHeight Sessionen tar aldrig ägarskap av

AComponent

AttachComponent; endast klonerna lagras, så anroparen behåller och frigör den skickade instansen oberoende av sessionen Sessionskonstruktorn anropar Nil, så en session som skapats med en

Exempel

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ärden

`1`	Båda klonerna skapades och bekräftades som nya initiala och aktuella ögonblicksbilder, med allt förloppstillstånd rensat
`0`	`AComponent` är `Nil` eller ett av `CloneComponent`-anropen returnerade `Nil`, och de tidigare ögonblicksbilderna och tillståndet bevaras

Se även

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout