GarbageCollectObjects

文件屬性, 優化

描述

立即對目前選取的文件執行標記-清理垃圾回收（Garbage Collection），以清除所有孤立的間接物件（即從目錄參照樹中無法再存取的物件）

語法

Delphi

Function TPDFlib.GarbageCollectObjects: Integer;

ActiveX

Function PDFlib::GarbageCollectObjects() As Long

DLL

int DLGarbageCollectObjects(int InstanceID);

傳回值

Negative value	垃圾回收期間出錯
>= 0	從文件中清除的孤立間接 PDF 物件的数量

備註

這在進行密集的文件編輯、頁面擷取或物件刪除後非常有用，可以在儲存前縮小文件檔案體積。您也可以使用 SetGarbageCollect 設定儲存時の自動垃圾回收

範例

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

另見

SetGarbageCollect, GetGarbageCollect