procedure RemoveObject(Index: Integer; DestroyObject: Boolean = True);
| Index | Integer. Índice iniciado em zero do objeto de página a remover (0 a ObjectCount - 1) |
| DestroyObject | Boolean. Quando True (padrão), o objeto subjacente do PDFium é liberado após a remoção. Passe False para desanexar o objeto da página sem liberar sua memória, por exemplo ao transferi-lo para outra página |
RemoveObject exclui um objeto de página da página atual pelo seu índice iniciado em zero. Os valores válidos de índice vão de 0 a ObjectCount - 1. Após a chamada, o fluxo de conteúdo da página é regenerado automaticamente, para que a mudança seja refletida imediatamente
Quando DestroyObject é True (o padrão), o handle do objeto subjacente do PDFium é liberado e sua memória é desalocada. Quando False, o objeto é apenas desanexado da página sem ser destruído — isso é útil ao mover um objeto de uma página para outra, quando o chamador assume a propriedade do handle
Como remover um objeto desloca os índices de todos os objetos subsequentes, tome cuidado ao remover vários objetos em um laço: itere do índice mais alto para baixo, ou colete os índices a remover antes de iniciar o laço
// 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;