AttachComponent
Partes de documento, datos variables, edición de documentos
Descripción
Sustituye las instantáneas de componente inicial y actual de un TPDFlibDynamicComponentSession por clones nuevos de un componente propiedad del llamador y borra todo el estado de progreso
Sintaxis
Function TPDFlibDynamicComponentSession.AttachComponent(
AComponent: TPDFlibDynamicComponent): Integer;
Parámetros
AComponent | Componente propiedad del llamador cuyo CloneComponent proporciona tanto la nueva instantánea inicial como la nueva instantánea actual |
|---|
Observaciones
Ambos clones se crean antes de liberar cualquier instantánea almacenada, de modo que un CloneComponent que devuelva Nil deja intactos el componente anterior, el número de composiciones, el indicador de finalización y el estado de reintento
Si la operación tiene éxito, la sesión libera sus instantáneas antiguas, almacena el nuevo par y restablece
CompositionCount a cero, así como Completed, KeepTogetherRetryPending, LastRetryReason y LastRequiredSlotHeight
La sesión nunca toma la propiedad de
AComponent
AttachComponent; solo se almacenan los clones, de modo que el llamador conserva y libera la instancia pasada de forma independiente
El constructor de la sesión llama a Nil, de modo que una sesión creada con un componente
Ejemplo
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;
Valores devueltos
1 | Ambos clones se crearon y se confirmaron como las nuevas instantáneas inicial y actual, con todo el estado de progreso borrado |
|---|---|
0 | AComponent es Nil o una de las llamadas a CloneComponent devolvió Nil, y las instantáneas y el estado anteriores se conservan |
Véase también
TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout