ObjectType - TPdf - PDFium Delphi Component

组件: TPdf · 单元: PDFium

返回指定索引处页面对象的类别——文本、路径、图像、渐变或表单 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 轴向/径向/coon 渐变）
otForm — form XObject：可重用的子流，其自身可能包含文本、路径和图像

该分类稳定且廉价；在遍历 ObjectCount 的紧密循环中调用它是决定调用哪个更昂贵访问器（ObjectBitmap、 ObjectBounds、字符属性）之前分诊页面内容的标准方式

此属性不递归展开 form XObject — 类型报告 otForm，如果调用方需要叶级内容，必须向下进入 form 自身的对象列表

Remarks

此处的索引空间是页面的完整对象列表；这比 Image 和 Bitmap 使用的仅图像索引更宽
页面对象顺序大致匹配绘制顺序，因此按递增索引迭代是从下到上渲染
对于超出有效范围的索引返回 otText；务必用 ObjectCount 防护
枚举值镜像底层原生 API 中 PDFium 的 FPDF_PAGEOBJ_* 常量

Example

// 当前页面上对象类型的直方图
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