CloneComponent
Documentonderdelen, variabele gegevens, documentbewerking
Beschrijving
Abstracte methode van TPDFlibDynamicComponent die een onafhankelijke kopie van de component teruggeeft, inclusief alle muteerbare pagineringsstatus
Syntaxis
Function TPDFlibDynamicComponent.CloneComponent:
TPDFlibDynamicComponent; Virtual; Abstract;
Opmerkingen
Overschrijvingen moeten elk veld kopiëren dat Compose muteert, omdat de sessie samenstelt op een werkklon en die klon pas vastlegt nadat zijn Form XObject is gevalideerd en geplaatst
De sessie vertrouwt op de klon op verschillende plaatsen:
AttachComponent kloont tweemaal voor de begin- en huidige snapshots, ComposeNextLayout kloont eenmaal per poging voor de werkcomponent, en CloneCurrentComponent kloont de vastgelegde snapshot ter inspectie
De aanroeper van
CloneComponent is eigenaar van de teruggegeven instantie en geeft deze onafhankelijk van de broncomponent vrij
Een
Nil-resultaat wordt door de sessie als mislukte klonering behandeld; de sessie wijst dan de oorspronkelijke bewerking af zonder opgeslagen status te wijzigen
Voorbeeld
function TNumberedPagesComponent.CloneComponent:
TPDFlibDynamicComponent;
begin
Result := TNumberedPagesComponent.Create(FNextPage, FPageCount);
end;
Retourwaarden
| Nieuwe instantie | Een onafhankelijke kopie waarvan latere Compose-aanroepen de broncomponent niet kunnen beïnvloeden |
|---|---|
Nil | De overschrijving kon geen kopie maken; de sessie wijst AttachComponent en samenstellingspogingen die van de klon afhankelijk zijn af |
Zie ook
TPDFlibDynamicComponent, TPDFlibDynamicComponentSession, Compose, CloneCurrentComponent, AttachComponent