AttachComponent

Dokumentumrészek, változó adatok, dokumentumszerkesztés

Leírás

Egy TPDFlibDynamicComponentSession kezdeti és aktuális komponens-pillanatképeit friss klónokra cseréli egy hívó által birtokolt komponensből, és törli az összes előrehaladási állapotot

Szintaxis

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

Paraméterek

`AComponent`	A hívó által birtokolt komponens, amelynek `CloneComponent` metódusa szolgáltatja az új kezdeti és az új aktuális pillanatképet is

Megjegyzések

Mindkét klón létrehozásra kerül, mielőtt bármely tárolt pillanatkép felszabadulna, így a CloneComponent-t visszaadó Nil érintetlenül hagyja az előző komponenst, a kompozíciószámot, a befejezettségi jelzőt és az újrapróbálási állapotot Siker esetén a munkamenet felszabadítja a régi pillanatképeit, tárolja az új párt, és nullára állítja a

CompositionCount értékét, valamint alaphelyzetbe hozza a Completed, KeepTogetherRetryPending, LastRetryReason és LastRequiredSlotHeight értékeket A munkamenet soha nem veszi birtokba a

AComponent

AttachComponent-et; csak a klónok tárolódnak, így a hívó az átadott példányt önállóan őrzi meg és szabadítja fel A munkamenet konstruktora meghívja a Nil metódust, így a

Példa

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;

Visszatérési értékek

`1`	Mindkét klón létrehozásra és az új kezdeti illetve aktuális pillanatképként véglegesítésre került, az összes előrehaladási állapot törlésével
`0`	A `AComponent` `Nil`, vagy a `CloneComponent` hívások egyike `Nil`-t adott vissza, és az előző pillanatképek és állapot megőrződtek

Lásd még

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout