CloneComponent

Dokumentdele, variabeldata, dokumentredigering

Beskrivelse

Abstrakt metode i TPDFlibDynamicComponent, der returnerer en kalder-uafhængig kopi af komponenten inklusive al mutbar pagineringstilstand

Syntaks

Function TPDFlibDynamicComponent.CloneComponent:
  TPDFlibDynamicComponent; Virtual; Abstract;

Bemærkninger

Tilsidesættelser skal kopiere hvert felt, som Compose muterer, fordi sessionen komponerer på en arbejdsklon og først binder klonen fast, efter dens Form XObject er valideret og placeret Sessionen er afhængig af klonen flere steder:

AttachComponent kloner to gange for det første og aktuelle snapshot, ComposeNextLayout kloner én gang pr. forsøg for arbejdskomponenten, og CloneCurrentComponent kloner det bundne snapshot til inspektion Kalderen af

CloneComponent ejer den returnerede instans og frigiver den uafhængigt af kildekomponenten Et

Nil-resultat behandles af sessionen som en kloningsfejl, som derefter afviser den udløsende operation uden at ændre gemt tilstand

Eksempel

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

Returværdier

Ny instans	En uafhængig kopi, hvis senere `Compose`-kald ikke kan påvirke kildekomponenten
`Nil`	Tilsidesættelsen kunne ikke frembringe en kopi; sessionen afviser `AttachComponent` og komponeringsforsøg, der afhænger af klonen

Se også

TPDFlibDynamicComponent, TPDFlibDynamicComponentSession, Compose, CloneCurrentComponent, AttachComponent