AttachComponent

Documentonderdelen, variabele gegevens, documentbewerking

Beschrijving

Vervangt de begin- en huidige componentsnapshots van een TPDFlibDynamicComponentSession door verse klonen van een component die de aanroeper bezit en wist alle voortgangsstatus

Syntaxis

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

Syntaxis

`AComponent`	Component die de aanroeper bezit en waarvan `CloneComponent` zowel de nieuwe begin- als de nieuwe huidige snapshot levert

Opmerkingen

Beide klonen worden aangemaakt voordat een opgeslagen snapshot wordt vrijgegeven, dus een CloneComponent die Nil teruggeeft laat de vorige component, de samenstellingsteller, de voltooiingsvlag en de herhalingsstatus onaangetast Bij succes geeft de sessie zijn oude snapshots vrij, slaat het nieuwe paar op en reset

CompositionCount naar nul, Completed, KeepTogetherRetryPending, LastRetryReason en LastRequiredSlotHeight De sessie neemt nooit het eigendom van

AComponent

AttachComponent; alleen de klonen worden opgeslagen, dus de aanroeper houdt de doorgegeven instantie onafhankelijk aan en geeft deze vrij De sessieconstructor roept Nil aan, dus een sessie die met een

Voorbeeld

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;

Retourwaarden

`1`	Beide klonen zijn aangemaakt en vastgelegd als de nieuwe begin- en huidige snapshots, met alle voortgangsstatus gewist
`0`	`AComponent` is `Nil` of een van de `CloneComponent`-aanroepen gaf `Nil` terug, en de vorige snapshots en status zijn behouden

Zie ook

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout