procedure RemoveObject(Index: Integer; DestroyObject: Boolean = True);
| Index | Integer. Op nul gebaseerde index van het te verwijderen pagina-object (0 tot ObjectCount - 1). |
| DestroyObject | Boolean. Wanneer True (standaard), wordt het onderliggende PDFium-object na verwijdering vrijgegeven en het geheugen vrijgemaakt. Geef False door om het object van de pagina te ontkoppelen zonder het geheugen vrij te maken, bijvoorbeeld bij overdracht naar een andere pagina. |
RemoveObject verwijdert een pagina-object van de huidige pagina op zijn op nul gebaseerde index. Geldige indexwaarden lopen van 0 tot ObjectCount - 1. Na de aanroep wordt de pagina-inhoudsstroom automatisch opnieuw gegenereerd zodat de wijziging onmiddellijk wordt weerspiegeld.
Wanneer DestroyObject True is (de standaard), wordt de onderliggende PDFium-objecthandle vrijgegeven en zijn geheugen vrijgemaakt. Wanneer False, wordt het object slechts van de pagina ontkoppeld zonder te worden vernietigd — dit is nuttig bij het verplaatsen van een object van de ene pagina naar de andere, waar de aanroeper eigenaar wordt van de handle.
Omdat het verwijderen van een object de indices van alle volgende objecten verschuift, wees voorzichtig bij het verwijderen van meerdere objecten in een lus: doorloop van de hoogste index naar beneden, of verzamel de te verwijderen indices voordat u de lus start.
// 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;