PDFium Delphi Component Docs

מתודת ReadStructureElements

Component: TPdf  ·  Unit: PDFium
קורא תמונת מצב בבעלות מלאה של עץ המבנה ששורשו בעמוד אחד

Syntax

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

Description

ReadStructureElements עובר על עץ המבנה המתויג עבור PageNumber (מבוסס־אחד) ומחזיר מערך TPdfStructureElements בבעלות מלאה עם הסוגים, הכותרות, ה-MCIDs, אינדקסי הילדים ונתוני ההפניות

Status מסביר תוצאה ריקה, ומפריד בין מסמך שאינו מתויג לבין קריאה חסומה או כושלת

Remarks

    • בדקו קודם באמצעות IsTagged אם למסמך יש עץ מבנה כלשהו
    • קריאות חוזרות נענות מתוך מטמון המבנה; ראו StructureCacheCapacity ו־StructureElementsForPage
    • לעצים עמוקים מאוד, העדיפו את VisitStructureElements, שמזרים את הביקורים במקום לממש את כל המערך

Example

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

See Also