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 instanciaUna copia independiente cuyas llamadas posteriores a Compose no pueden afectar al componente de origen
NilLa 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