GarbageCollectObjects

Propiedades del documento, Optimización

Descripción

Realiza un barrido inmediato de recolección de basura mediante mark-sweep (marcado y barrido) en el documento seleccionado actualmente para eliminar cualquier objeto indirecto huérfano (objetos que ya no son accesibles desde el árbol de referencias del catálogo)

Sintaxis

Delphi

Function TPDFlib.GarbageCollectObjects: Integer;

ActiveX

Function PDFlib::GarbageCollectObjects() As Long

DLL

int DLGarbageCollectObjects(int InstanceID);

Valores de retorno

Negative value	Error durante la recolección de basura
>= 0	El número de objetos PDF indirectos huérfanos que se eliminaron del documento

Comentarios

Esto es útil después de una edición intensiva del documento, extracción de páginas o eliminación de objetos, para reducir el tamaño del documento antes de guardarlo; también puede configurar la recolección de basura automática durante el guardado usando SetGarbageCollect

Ejemplo

PDF.LoadFromFile('edit.pdf', '');
PDF.DeletePages(5, 10); // eliminar algunas páginas
PDF.GarbageCollectObjects; // liberar objetos no referenciados de inmediato
PDF.SaveToFile('edit_cleaned.pdf');

Véase también

SetGarbageCollect, GetGarbageCollect