CloneComponent
Parties de document, données variables, édition de documents
Description
Méthode abstraite de TPDFlibDynamicComponent qui renvoie une copie indépendante de l'appelant du composant, y compris tout l'état de pagination modifiable
Syntaxe
Function TPDFlibDynamicComponent.CloneComponent:
TPDFlibDynamicComponent; Virtual; Abstract;
Remarques
Les redéfinitions doivent copier chaque champ que Compose modifie, car la session compose sur un clone de travail et ne valide ce clone qu'après validation et placement de son Form XObject
La session repose sur le clone à plusieurs endroits :
AttachComponent clone deux fois pour les instantanés initial et courant, ComposeNextLayout clone une fois par tentative pour le composant de travail, et CloneCurrentComponent clone l'instantané validé pour inspection
L'appelant de
CloneComponent est propriétaire de l'instance renvoyée et la libère indépendamment du composant source
Un résultat
Nil est traité comme un échec de clonage par la session, qui rejette alors l'opération à l'origine de l'appel sans modifier l'état stocké
Exemple
function TNumberedPagesComponent.CloneComponent:
TPDFlibDynamicComponent;
begin
Result := TNumberedPagesComponent.Create(FNextPage, FPageCount);
end;
Valeurs de retour
| Nouvelle instance | Une copie indépendante dont les appels Compose ultérieurs ne peuvent pas affecter le composant source |
|---|---|
Nil | La redéfinition n'a pas pu produire de copie ; la session rejette AttachComponent et les tentatives de composition dépendant du clone |
Voir aussi
TPDFlibDynamicComponent, TPDFlibDynamicComponentSession, Compose, CloneCurrentComponent, AttachComponent