CloneComponent

Partes de documento, datos variables, edición de documentos

Descripción

Método abstracto de TPDFlibDynamicComponent que devuelve una copia independiente del llamador del componente, 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 solo confirma ese clon después de que su Form XObject se haya 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 su inspección El llamador de

CloneComponent es propietario de la instancia devuelta y la libera con independencia 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 de origen 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