PDFium Component Docs

RemoveObject Yöntem

Bu API girdisi tanımlayıcıları, imzaları, kod bloklarını ve PDF terimlerini özgün biçiminde korur.
Bileşen: TPdf  ·  Birim: PDFium
Geçerli page'den belirtilen page object'i kaldırır. DestroyObject True olduğunda, kaldırılan object işlemden sonra serbest bırakılır. Page content stream otomatik olarak yeniden oluşturulur

Söz dizimi

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

IndexTamsayı. Kaldırılacak page object'in 0 tabanlı dizini (0 ile ObjectCount - 1 arası)
DestroyObjectBoolean. True olduğunda (varsayılan) alttaki PDFium object kaldırma işleminden sonra serbest bırakılır. False geçirerek object'i belleğini serbest bırakmadan page'den ayırın; örneğin onu başka bir page'e taşırken

Açıklama

RemoveObject, geçerli sayfadaki bir page object'i 0 tabanlı dizinine göre siler. Geçerli dizin değerleri 0 ile ObjectCount - 1 arasındadır. Çağrıdan sonra page content stream otomatik olarak yeniden oluşturulur; böylece değişiklik hemen yansır

DestroyObject True olduğunda (varsayılan) alttaki PDFium object handle'ı serbest bırakılır ve belleği boşaltılır. False olduğunda object yalnızca page'den ayrılır ama yok edilmez — bu, bir object'i bir page'den diğerine taşırken kullanışlıdır ve handle'ın sahipliği çağırana geçer

Bir object'i silmek sonraki tüm object'lerin dizinlerini kaydırdığı için, bir döngü içinde birden çok object silerken dikkatli olun: en yüksek dizinden aşağı doğru ilerleyin ya da silinecek dizinleri döngüye başlamadan önce toplayın

Örnek

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

Ayrıca bkz.

ObjectCount, ObjectType, AddPath