GarbageCollectObjects
מאפייני מסמך, אופטימיזציה
תיאור
מבצע איסוף זבל מסוג mark-sweep באופן מיידי במסמך שנבחר כעת כדי להסיר אובייקטים עקיפים יתומים (אובייקטים שאינם נגישים עוד מעץ ההתייחסות של הקטלוג)
תחביר
Delphi
Function TPDFlib.GarbageCollectObjects: Integer;ActiveX
Function PDFlib::GarbageCollectObjects() As LongDLL
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');