PDFium Delphi Component Docs

RemoveObject Método

Componente: TPdf  ·  Unidad: PDFium
Elimina el objeto de página especificado de la página actual. Cuando DestroyObject es True, el objeto eliminado se libera después de la eliminación. El flujo de contenido de la página se regenera automáticamente

Syntax

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

IndexInteger. Índice basado en cero del objeto de página a eliminar (0 a ObjectCount - 1)
DestroyObjectBoolean. Cuando es True (predeterminado), el objeto PDFium subyacente se libera tras la eliminación. Pase False para separar el objeto de la página sin liberar su memoria, por ejemplo al transferirlo a otra página

Description

RemoveObject elimina un objeto de página de la página actual por su índice basado en cero. Los valores de índice válidos van de 0 a ObjectCount - 1. Después de la llamada, el flujo de contenido de la página se regenera automáticamente para que el cambio se refleje de inmediato

Cuando DestroyObject es True (el valor predeterminado), el manejador de objeto PDFium subyacente se libera y su memoria se libera. Cuando es False, el objeto simplemente se separa de la página sin destruirse — esto es útil al mover un objeto de una página a otra, donde el llamador toma posesión del manejador

Debido a que eliminar un objeto desplaza los índices de todos los objetos posteriores, tenga cuidado al eliminar varios objetos en un bucle: itere desde el índice más alto hacia abajo, o recopile los índices a eliminar antes de iniciar el bucle

Example

// Eliminar el último objeto de página
if Pdf1.ObjectCount > 0 then
  Pdf1.RemoveObject(Pdf1.ObjectCount - 1);

// Eliminar todos los objetos desde el índice más alto hacia abajo
var I: Integer;
begin
  for I := Pdf1.ObjectCount - 1 downto 0 do
    Pdf1.RemoveObject(I);
end;

See Also

ObjectCount, ObjectType, AddPath