AttachComponent
Parties de document, données variables, édition de documents
Description
Remplace les instantanés de composant initial et courant d'une TPDFlibDynamicComponentSession par des clones neufs d'un composant détenu par l'appelant et efface tout l'état de progression
Syntaxe
Function TPDFlibDynamicComponentSession.AttachComponent(
AComponent: TPDFlibDynamicComponent): Integer;
Paramètres
AComponent | Composant détenu par l'appelant dont CloneComponent fournit à la fois le nouvel instantané initial et le nouvel instantané courant |
|---|
Remarques
Les deux clones sont créés avant la libération de tout instantané stocké, de sorte qu'un CloneComponent renvoyant Nil laisse le composant précédent, le compteur de compositions, l'indicateur d'achèvement et l'état de nouvelle tentative intacts
En cas de succès, la session libère ses anciens instantanés, stocke la nouvelle paire et réinitialise
CompositionCount à zéro ainsi que Completed, KeepTogetherRetryPending, LastRetryReason et LastRequiredSlotHeight
La session ne prend jamais possession de
AComponent
AttachComponent ; seuls les clones sont stockés, si bien que l'appelant conserve et libère l'instance transmise de manière indépendante
Le constructeur de la session appelle Nil, si bien qu'une session créée avec un composant
Exemple
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;
Valeurs de retour
1 | Les deux clones ont été créés et validés comme nouveaux instantanés initial et courant, avec tout l'état de progression effacé |
|---|---|
0 | AComponent vaut Nil ou l'un des appels CloneComponent a renvoyé Nil, et les instantanés et l'état précédents sont préservés |
Voir aussi
TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout