เมธอด ReadStructureElements

Component: TPdf · Unit: PDFium

อ่าน snapshot ของ structure tree ที่หยั่งรากอยู่ที่หน้าเดียว โดยเป็นข้อมูลที่ผู้เรียกเป็นเจ้าของ

Syntax

function ReadStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; out Status: TPdfStructureReadStatus): TPdfStructureElements;

Description

เมธอด ReadStructureElements เดิน structure tree แบบ tagged ของ PageNumber (one-based) แล้วคืนอาร์เรย์ TPdfStructureElements ที่ผู้เรียกเป็นเจ้าของ พร้อมข้อมูลชนิด ชื่อเรื่อง MCIDs kid index และข้อเท็จจริงด้าน reference

Status อธิบายผลลัพธ์ที่ว่างเปล่า และแยกกรณีเอกสารไม่มี tagging ออกจากการอ่านที่ถูกจำกัดขอบเขตหรือล้มเหลว

Remarks

เรียก IsTagged ก่อนเพื่อเช็กว่าเอกสารมี structure tree หรือไม่เลย
การอ่านซ้ำจะให้บริการจาก structure cache ดู StructureCacheCapacity และ StructureElementsForPage
สำหรับ tree ที่ลึกมาก ควรใช้ VisitStructureElements ซึ่งส่ง element ออกมาแบบ streaming แทนการสร้างอาร์เรย์ทั้งก้อนขึ้นมาพร้อมกัน

Example

var St: TPdfStructureReadStatus;
Elements := Pdf1.ReadStructureElements(1, Default(TPdfStructureReadOptions), St);