CloneComponent
Partes de documentos, datos variables, edición de documentos
Descripción
Método abstracto de TPDFlibDynamicComponent que devuelve una copia del componente independiente de quien llama, incluido todo su estado de paginación mutable
Sintaxis
Function TPDFlibDynamicComponent.CloneComponent:
TPDFlibDynamicComponent; Virtual; Abstract;
Observaciones
Las anulaciones deben copiar cada campo que Compose muta, porque la sesión compone sobre un clon de trabajo y confirma ese clon solo después de que su Form XObject haya sido validado y colocado
La sesión se apoya en el clon en varios lugares:
AttachComponent clona dos veces para las instantáneas inicial y actual, ComposeNextLayout clona una vez por intento para el componente de trabajo, y CloneCurrentComponent clona la instantánea confirmada para inspección
Quien llama a
CloneComponent es propietario de la instancia devuelta y la libera independientemente del componente de origen
Un resultado
Nil se trata como un fallo de clonación por parte de la sesión, que entonces rechaza la operación originante sin cambiar el estado almacenado
Ejemplo
function TNumberedPagesComponent.CloneComponent:
TPDFlibDynamicComponent;
begin
Result := TNumberedPagesComponent.Create(FNextPage, FPageCount);
end;
Valores devueltos
| Nueva instancia | Una copia independiente cuyas llamadas posteriores a Compose no pueden afectar al componente de origen |
|---|---|
Nil | La anulación no pudo producir una copia; la sesión rechaza AttachComponent y los intentos de composición que dependen del clon |
Véase también
TPDFlibDynamicComponent, TPDFlibDynamicComponentSession, Compose, CloneCurrentComponent, AttachComponent