PDFium Delphi Component Docs

RemoveObject Metod

Component: TPdf  ·  Unit: PDFium
Tar bort det angivna sidobjektet från den aktuella sidan. När DestroyObject är True frisläpps det borttagna objektet efter borttagningen. Sidans innehållsström byggs om automatiskt

Syntax

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

IndexInteger. Nollbaserat index för sidobjektet som ska tas bort (0 till ObjectCount - 1)
DestroyObjectBoolean. När True (standardvärde) frisläpps det underliggande PDFium-objektet efter borttagningen. Skicka False för att koppla loss objektet från sidan utan att frisläppa dess minne, till exempel vid överföring till en annan sida

Description

RemoveObject tar bort ett sidobjekt från den aktuella sidan via sitt nollbaserade index. Giltiga indexvärden sträcker sig från 0 till ObjectCount - 1. Efter anropet byggs sidans innehållsström om automatiskt så att ändringen återspeglas omedelbart

När DestroyObject är True (standardvärdet) frisläpps det underliggande PDFium-objekthandtaget och dess minne frigörs. När False kopplas objektet bara loss från sidan utan att förstöras — detta är användbart när ett objekt flyttas från en sida till en annan och anroparen tar över ägandet av handtaget

Eftersom borttagning av ett objekt skiftar indexen för alla efterföljande objekt bör du vara försiktig när du tar bort flera objekt i en loop: iterera från det högsta indexet nedåt, eller samla ihop indexen som ska tas bort innan loopen påbörjas

Example

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

See Also

ObjectCount, ObjectType, AddPath