procedure RemoveObject(Index: Integer; DestroyObject: Boolean = True);
| Index | Integer. Indeks liczony od zera obiektu strony do usunięcia (od 0 do ObjectCount - 1) |
| DestroyObject | Boolean. Gdy True (domyślnie), bazowy obiekt PDFium jest zwalniany po usunięciu. Przekaż False, aby odłączyć obiekt od strony bez zwalniania jego pamięci, na przykład przy przenoszeniu go na inną stronę |
RemoveObject usuwa obiekt strony z bieżącej strony według indeksu liczonego od zera. Prawidłowe wartości indeksu mieszczą się w zakresie od 0 do ObjectCount - 1. Po wywołaniu strumień zawartości strony jest odtwarzany automatycznie, więc zmiana jest widoczna natychmiast
Gdy DestroyObject ma wartość True (domyślnie), bazowy uchwyt obiektu PDFium jest zwalniany, a jego pamięć uwalniana. Gdy False, obiekt jest jedynie odłączany od strony bez niszczenia — przydaje się to przy przenoszeniu obiektu z jednej strony na drugą, gdy wywołujący przejmuje własność uchwytu
Ponieważ usunięcie obiektu przesuwa indeksy wszystkich kolejnych obiektów, zachowaj ostrożność przy usuwaniu wielu obiektów w pętli: iteruj od najwyższego indeksu w dół albo zbierz indeksy do usunięcia przed rozpoczęciem pętli
// 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;