PDFium Delphi Component Docs

ObjectCount الخاصية

Component: TPdf  ·  Unit: PDFium
عدد للقراءة فقط لكائنات الصفحة (text و path و image و shading و form) في الصفحة الحالية

Syntax

property ObjectCount: Integer; // read only

Description

تُرجع عدد كائنات الصفحة (نص ومسار وصورة وتظليل ونموذج) المقترنة بمستند PDF المفتوح. ويتغير العدد عندما يُسند إلى Page فهرس صفحة مختلف، فيصلح حدًا أعلى لحلقة for تستعرض كل ObjectHandle[Index].

تُقرأ القيمة مباشرة من محرك 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