PDFium Delphi Component 文件

ObjectCount 屬性

元件: TPdf  ·  單元: PDFium
目前頁面上頁面物件(文字、路徑、影像、網底、表單)的唯讀數量

Syntax

property ObjectCount: Integer; // read only

Description

傳回與已開啟 PDF 文件相關聯的頁面物件(文字、路徑、影像、網底、表單)數量。當 Page 被指定為不同的頁面索引時數量會隨之改變, 因此可作為逐一走訪每個 ObjectHandle[Index] 的 for 迴圈上限

此值直接從底層 PDFium 引擎讀取(要求 Active 為 True 且已載入目前頁面)。當文件已關閉、查詢範圍內沒有頁面物件 (文字、路徑、影像、網底、表單),或此屬性不適用於目前的 PDF 時, 結果為 0

此計數器由 PDFium 在首次存取時延遲計算,第一次呼叫可能觸發 相關物件串流的解析(例如頁面的 /Annots 陣列或文件的 /Names 樹狀結構)。後續呼叫為 O(1)

Remarks

Example

var

  I: Integer;

begin

  if not Pdf1.Active then Exit;

  Memo1.Lines.Add(Format('%d page objects (text, path, image, shading, form)', [Pdf1.ObjectCount]));

  for I := 0 to Pdf1.ObjectCount - 1 do

  begin

    // inspect each item

    Memo1.Lines.Add(Format(' [%d]', [I]));

  end;

end;

See Also

ObjectHandle, ObjectBounds, ObjectTransparent