GarbageCollectObjects

Dokumenteigenschaften, Optimierung

Beschreibung

Führt sofort eine Mark-Sweep-Bereinigung (Garbage Collection) für das aktuell ausgewählte Dokument durch, um verwaiste indirekte Objekte zu entfernen (Objekte, die vom Katalogreferenzbaum aus nicht mehr erreichbar sind)

Syntax

Delphi

Function TPDFlib.GarbageCollectObjects: Integer;

ActiveX

Function PDFlib::GarbageCollectObjects() As Long

DLL

int DLGarbageCollectObjects(int InstanceID);

Rückgabewerte

Negative value	Fehler während der Garbage-Collection
>= 0	Die Anzahl der verwaisten indirekten PDF-Objekte, die aus dem Dokument entfernt wurden

Bemerkungen

Dies ist nützlich nach intensiver Dokumentbearbeitung, Seitenextraktion oder Objektlöschung, um die Dokumentgröße vor dem Speichern zu verringern. Sie können die automatische Garbage Collection während des Speicherns auch mit SetGarbageCollect konfigurieren

Beispiel

PDF.LoadFromFile('edit.pdf', '');
PDF.DeletePages(5, 10); // delete some pages
PDF.GarbageCollectObjects; // free unreferenced objects immediately
PDF.SaveToFile('edit_cleaned.pdf');

Siehe auch

SetGarbageCollect, GetGarbageCollect