AttachComponent

Části dokumentů, variabilní data, úpravy dokumentů

Popis

Nahradí počáteční i aktuální snímek komponenty v TPDFlibDynamicComponentSession čerstvými klony komponenty vlastněné volajícím a vymaže veškerý stav průběhu

Syntaxe

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

Parametry

`AComponent`	Komponenta vlastněná volajícím, jejíž `CloneComponent` dodá nový počáteční i nový aktuální snímek

Poznámky

Oba klony se vytvoří dříve, než se uvolní jakýkoli uložený snímek, takže CloneComponent vracející Nil ponechá předchozí komponentu, počet kompozic, příznak dokončení i stav opakování nedotčené Při úspěchu relace uvolní staré snímky, uloží novou dvojici a vynuluje

CompositionCount, Completed, KeepTogetherRetryPending, LastRetryReason a LastRequiredSlotHeight Relace nikdy nepřebírá vlastnictví

AComponent

AttachComponent; ukládají se pouze klony, takže volající si předanou instanci ponechává a uvolňuje nezávisle Konstruktor relace volá Nil, takže relace vytvořená s komponentou

Příklad

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;

Návratové hodnoty

`1`	Oba klony byly vytvořeny a potvrzeny jako nové počáteční a aktuální snímky s vymazaným veškerým stavem průběhu
`0`	`AComponent` je `Nil` nebo některé volání `CloneComponent` vrátilo `Nil`, přičemž předchozí snímky a stav zůstávají zachovány

Viz také

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout