GarbageCollectObjects

מאפייני מסמך, אופטימיזציה

תיאור

מבצע איסוף זבל מסוג mark-sweep באופן מיידי במסמך שנבחר כעת כדי להסיר אובייקטים עקיפים יתומים (אובייקטים שאינם נגישים עוד מעץ ההתייחסות של הקטלוג)

תחביר

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