AttachComponent

Części dokumentów, dane zmienne, edycja dokumentów

Opis

Zastępuje początkowy i bieżący zrzut komponentu w TPDFlibDynamicComponentSession świeżymi klonami komponentu należącego do wywołującego i czyści cały stan postępu

Składnia

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

Parametry

`AComponent`	Komponent należący do wywołującego, którego `CloneComponent` dostarcza zarówno nowy początkowy, jak i nowy bieżący zrzut

Uwagi

Oba klony są tworzone, zanim jakikolwiek zapisany zrzut zostanie zwolniony, więc CloneComponent zwracający Nil pozostawia poprzedni komponent, liczbę kompozycji, flagę ukończenia i stan ponawiania bez zmian W razie sukcesu sesja zwalnia stare zrzuty, zapisuje nową parę i zeruje

CompositionCount, Completed, KeepTogetherRetryPending, LastRetryReason i LastRequiredSlotHeight Sesja nigdy nie przejmuje własności

AComponent

AttachComponent; zapisywane są tylko klony, więc wywołujący niezależnie przechowuje i zwalnia przekazaną instancję Konstruktor sesji wywołuje Nil, więc sesja utworzona z komponentem

Przykład

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;

Wartości zwracane

`1`	Oba klony zostały utworzone i zatwierdzone jako nowy początkowy i bieżący zrzut, przy czym cały stan postępu został wyczyszczony
`0`	`AComponent` ma wartość `Nil` albo jedno z wywołań `CloneComponent` zwróciło `Nil`, a poprzednie zrzuty i stan pozostają zachowane

Zobacz również

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout