CloneComponent

Dokumentdelar, variabel data, dokumentredigering

Beskrivning

Abstrakt metod i TPDFlibDynamicComponent som returnerar en anropsoberoende kopia av komponenten inklusive allt föränderligt sidbrytningstillstånd

Syntax

Function TPDFlibDynamicComponent.CloneComponent:
  TPDFlibDynamicComponent; Virtual; Abstract;

Anmärkningar

Åsidosättningar måste kopiera vartje fält som Compose muterar, eftersom sessionen komponerar på en arbetsklon och först bekräftar den klonen efter att dess Form XObject har validerats och placerats Sessionen förlitar sig på klonen på flera ställen:

AttachComponent klonar två gånger för den initiala och aktuella ögonblicksbilden, ComposeNextLayout klonar en gång per försök för arbetskomponenten, och CloneCurrentComponent klonar den bekräftade ögonblicksbilden för inspektion Anroparen av

CloneComponent äger den returnerade instansen och frigör den oberoende av källkomponenten Ett

Nil-resultat behandlas av sessionen som ett klonfel, vilket då avvisar den ursprungliga operationen utan att ändra lagrat tillstånd

Exempel

function TNumberedPagesComponent.CloneComponent:
  TPDFlibDynamicComponent;
begin
  Result := TNumberedPagesComponent.Create(FNextPage, FPageCount);
end;

Returvärden

Ny instans	En oberoende kopia vars senare `Compose`-anrop inte kan påverka källkomponenten
`Nil`	Åsidosättningen kunde inte framställa en kopia; sessionen avvisar `AttachComponent` och de kompositionsförsök som är beroende av klonen

Se även

TPDFlibDynamicComponent, TPDFlibDynamicComponentSession, Compose, CloneCurrentComponent, AttachComponent