procedure RemoveObject(Index: Integer; DestroyObject: Boolean = True);
| Index | Integer. فهرس كائن الصفحة المطلوب إزالته صفري الأساس (من 0 إلى ObjectCount - 1). |
| DestroyObject | Boolean. عندما يكون True (الافتراضي)، يُحرر كائن PDFium الأساسي بعد الإزالة. مرِّر False لفصل الكائن عن الصفحة دون تحرير ذاكرته، مثلًا عند نقله إلى صفحة أخرى. |
يحذف RemoveObject كائن صفحة من الصفحة الحالية بفهرسه الصفري. تتراوح قيم الفهرس الصالحة من 0 إلى ObjectCount - 1. بعد الاستدعاء، يُعاد توليد تيار محتوى الصفحة تلقائيًا بحيث ينعكس التغيير فورًا.
عندما يكون DestroyObject هو True (الافتراضي)، يُحرر مقبض كائن PDFium الأساسي وتُحرر ذاكرته. عندما يكون False، يُفصل الكائن عن الصفحة دون تدميره — يفيد هذا عند نقل كائن من صفحة إلى أخرى، حيث يأخذ المستدعي ملكية المقبض.
لأن إزالة كائن تزيح فهارس جميع الكائنات اللاحقة، كن حذرًا عند إزالة عدة كائنات في حلقة: كرر من أعلى فهرس نزولًا، أو اجمع الفهارس المطلوب إزالتها قبل بدء الحلقة.
// Remove the last page object
if Pdf1.ObjectCount > 0 then
Pdf1.RemoveObject(Pdf1.ObjectCount - 1);
// Remove all objects from highest index downward
var I: Integer;
begin
for I := Pdf1.ObjectCount - 1 downto 0 do
Pdf1.RemoveObject(I);
end;