THotPDF.FindStructureElementForMCID Method
يُحلّ قاموس StructElem المالك لتسلسل محتوى مُعلَّم (page, MCID) معطى، عبر قراءة مفتاح الصفحة /StructParents والفهرسة داخل شجرة ParentTree للمستند في زمن ثابت
التصريح
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;الوحدة
HPDFDoc
الوحدة
| المرجع | المرجع |
|---|---|
PageIndex | فهرس الصفحة، بدءًا من الصفر، التي يجري حلّ محتواها الموسوم |
MCID | معرّف المحتوى الموسوم (marked-content) المُصدَر في الصفحة والمربوط بـ ParentTree عبر AddStructureElement |
| المرجع | قاموس StructElem غير المباشر المالك، أو nil عندما تكون الصفحة غير موسومة أو الخانة فارغة أو أحد المعاملين خارج النطاق |
الوحدة
- تقرأ عدد
/StructParentsالصحيح للصفحة، ثم تُعيدFParentTree[key][MCID]مباشرة، بحيث يكون البحث مستقلًا عن عدد عناصر البنية - تُخزَّن المراجع غير المباشرة لـStructElem ملفوفة برابط داخل ParentTree؛ وتقوم الطريقة بحلّ الرابط إلى القاموس الهدف قبل الإرجاع
- لا تُطلق هذه الطريقة أي استثناء أبدًا: فالصفحة غير المُعلَّمة، أو الـMCID غير المخصَّص، أو الفتحة النائبة
/null، أو الوسائط خارج النطاق، كلها تؤول إلىnil - العنصر المُعاد هو نفس القاموس غير المباشر الناتج عن
AddStructureElement، وهو صالح كهدف/SDلدالةAddStructureDestinationLink