ObjectType - TPdf - PDFium Delphi Component

元件: TPdf · 單元: PDFium

傳回指定索引處頁面物件的類別 — 文字、路徑、影像、網底，或 form XObject。這個分類會對應到產生該物件的 PDF 內容串流運算子，讓呼叫端可以用單一 switch 分派走訪頁面物件陣列

Syntax

property ObjectType[Index: Integer]: TObjectType; // read only

Index 以 0 為基底的頁面物件索引，範圍為 0 到 ObjectCount - 1

Description

ObjectType 傳回描述 Index 處頁面物件種類的 TObjectType 列舉值：

otText — 文字顯示運算子（Tj、TJ、'、"）— 共用同一字型與文字矩陣的一串字形
otPath — 向量路徑：線段、曲線、矩形與填滿。使用 ObjectBounds 可取得頁面上的矩形
otImage — 點陣影像。搭配 ObjectBitmap 可取得像素
otShading — 漸層或以函式為基礎的網底圖樣（PDF axial/radial/coon 網底）
otForm — 表單 XObject：可重複使用的子串流，本身可再包含文字、路徑與影像

此分類結果穩定且成本低；在 ObjectCount 的緊密迴圈中呼叫它，是在決定要叫用哪個成本較高的存取子（ObjectBitmap、ObjectBounds、字元屬性）之前，對頁面內容進行分類檢傷的標準做法

此屬性不會遞迴展開表單 XObject — 型別只回報 otForm，呼叫者若需要葉層級內容，必須自行深入表單自己的物件清單

Remarks

這裡的索引空間是頁面的完整物件清單；比 Image 與 Bitmap 所用、僅限影像的索引更寬
頁面物件順序大致對應繪製順序，因此以遞增索引逐一迭代會呈現由下而上的效果
落在有效範圍外的索引會傳回 otText；務必以 ObjectCount 做防護
列舉值對應底層原生 API 中 PDFium 的 FPDF_PAGEOBJ_* 常數

Example

// Histogram of object types on the current page
var
  I: Integer;
  Counts: array[TObjectType] of Integer;
  T: TObjectType;
begin
  FillChar(Counts, SizeOf(Counts), 0);
  for I := 0 to Pdf.ObjectCount - 1 do
    Inc(Counts[Pdf.ObjectType[I]]);
  for T := Low(TObjectType) to High(TObjectType) do
    Memo1.Lines.Add(Format('%s: %d', [GetEnumName(TypeInfo(TObjectType), Ord(T)), Counts[T]]));
end;

ObjectType 屬性

元件: TPdf · 單元: PDFium

Syntax

Description

Remarks

Example

See Also