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