GarbageCollectObjects

Propriétés du document, Optimisation

Description

Effectue immédiatement un balayage de ramasse-miettes (garbage collection) de type mark-sweep sur le document actuellement sélectionné pour supprimer tous les objets indirects orphelins (objets qui ne sont plus accessibles à partir de l'arbre de référence du catalogue)

Syntaxe

Delphi

Function TPDFlib.GarbageCollectObjects: Integer;

ActiveX

Function PDFlib::GarbageCollectObjects() As Long

DLL

int DLGarbageCollectObjects(int InstanceID);

Valeurs de retour

Negative valueErreur lors de la garbage collection
>= 0Le nombre d'objets PDF indirects orphelins qui ont été supprimés du document

Remarques

Ceci est utile après une modification intensive du document, une extraction de page ou une suppression d'objet, afin de réduire la taille du document avant de l'enregistrer; vous pouvez également configurer la garbage collection automatique lors de l'enregistrement en utilisant SetGarbageCollect

Exemple

PDF.LoadFromFile('edit.pdf', '');
PDF.DeletePages(5, 10); // supprimer certaines pages
PDF.GarbageCollectObjects; // libérer immédiatement les objets non référencés
PDF.SaveToFile('edit_cleaned.pdf');

Voir aussi

SetGarbageCollect, GetGarbageCollect