EnumPathElements

الاستخراج، معالجة الصفحات

الوصف

يُعدّد كل كائن مسار متجه على صفحة عبر طبقات المحتوى جميعها. يُرفَع كل تتابع لبناء مسار ورسمه إلى سجل TPDFlibPageElement واحد بنوع Kind يساوي ekPath، وصندوق إحاطة يشمل نقط تحكّم المنحنيات، وعدد المقاطع، وعلم الإغلاق، واسم معامل الرسم. ويستلم كل عنصر أيضًا لقطة ElementID لاستعلامات التفاصيل لاحقًا

الصيغة

Delphi

Procedure TPDFlib.EnumPathElements(Page: Integer;
  Var Elements: Array Of TPDFlibPageElement;
  Var ElemIndex, TotalCount: Integer);

المعاملات

Pageرقم الصفحة أحادي الأساس المطلوب تعداده
Elementsمصفوفة يخصصها المستدعي من TPDFlibPageElement تستقبل السجلات؛ لا تُخزَّن إلا بعدد السجلات الذي تتسع له المصفوفة
ElemIndexفهرس داخلي وخارجي؛ مرّر 0 عند الدخول، وعند الخروج يحمل عدد السجلات المخزَّنة في Elements
TotalCountعدّاد داخلي وخارجي؛ عند الخروج يحمل العدد الإجمالي للمسارات الموجودة، حتى حين يتجاوز سعة Elements

ملاحظات

تُعاد الإحداثيات بنظام الإحداثيات ذي الأصل أعلى اليسار الذي تستخدمه مساعدات عناصر الصفحة. قارن ElemIndex بـ TotalCount لكشف الاقتطاع، أو استدعِ مرتين وحجّم المصفوفة من التمريرة الأولى

لتعداد أعلى مستوى يغطي أيضًا النصوص والصور ومواضع التظليل انظر EnumPageElements

مثال

Total:= 0;
SetLength(Elements, 0);
PDF.EnumPathElements(1, Elements, Count, Total);
SetLength(Elements, Total);
Count:= 0; Total:= 0;
PDF.EnumPathElements(1, Elements, Count, Total);