PDFium Component Docs

RemoveObject Methode

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Unit: PDFium
Verwijdert het opgegeven page object van de huidige pagina. Wanneer DestroyObject True is, wordt het verwijderde object na de verwijdering vrijgegeven. De page content stream wordt automatisch opnieuw gegenereerd

Syntaxis

procedure RemoveObject(Index: Integer; DestroyObject: Boolean = True);

IndexInteger. 0-gebaseerde index van het page object om te verwijderen (0 tot ObjectCount - 1)
DestroyObjectBoolean. Wanneer True (standaard), wordt het onderliggende PDFium-object na verwijdering vrijgegeven. Gebruik False om het object los te koppelen van de pagina zonder het geheugen vrij te geven, bijvoorbeeld wanneer u het naar een andere pagina verplaatst

Beschrijving

RemoveObject verwijdert een page object van de huidige pagina via de 0-gebaseerde index. Geldige indexwaarden lopen van 0 tot ObjectCount - 1. Na de aanroep wordt de page content stream automatisch opnieuw gegenereerd zodat de wijziging direct zichtbaar is

Wanneer DestroyObject True is (standaard), wordt de onderliggende PDFium-objecthandle vrijgegeven en het geheugen ervan vrijgemaakt. Wanneer False is, wordt het object alleen losgekoppeld van de pagina zonder te worden vernietigd — dat is handig wanneer u een object van de ene pagina naar de andere verplaatst en de aanroeper de handle overneemt

Omdat het verwijderen van een object de indexen van alle volgende objecten verschuift, moet u voorzichtig zijn bij het verwijderen van meerdere objecten in een lus: loop van de hoogste index naar beneden of verzamel de te verwijderen indexen voordat u begint

Voorbeeld

// 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;

Zie ook

ObjectCount, ObjectType, AddPath