GarbageCollectObjects

خصائص المستند، تحسين الحجم

الوصف

يقوم بإجراء عملية جمع القمامة بطريقة التعليم والمسح (mark-sweep) فورًا على المستند المحدد حاليًا لإزالة أي كائنات غير مباشرة يتيمة (كائنات لم يعد من الممكن الوصول إليها من شجرة مراجع الفهرس)

البنية

Delphi

Function TPDFlib.GarbageCollectObjects: Integer;

ActiveX

Function PDFlib::GarbageCollectObjects() As Long

DLL

int DLGarbageCollectObjects(int InstanceID);

القيم المرجعة

قيمة سالبةخطأ أثناء جمع القمامة
>= 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