PDFium Delphi Component Docs

ReadStructureElements metoda

Komponenta: TPdf  ·  Jednotka: PDFium
Přečte vlastněný snímek stromu struktury zakořeněného v jedné stránce

Syntaxe

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

Popis

ReadStructureElements projde tagovaným stromem struktury pro PageNumber (číslované od jedničky) a vrátí vlastněné pole TPdfStructureElements s typy, titulky, MCID, indexy potomků a fakty o odkazech

Status vysvětlí prázdný výsledek a odliší netagovaný dokument od ohraničeného či neúspěšného čtení

Poznámky

    • Nejprve pomocí IsTagged zjistěte, zda dokument vůbec obsahuje strom struktury
    • Opakovaná čtení obsluhuje strukturní cache; viz StructureCacheCapacity a StructureElementsForPage
    • U velmi hlubokých stromů dejte přednost VisitStructureElements, který průchody streamuje místo vybudování celého pole

Příklad

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

Viz také

VisitStructureElements, StructureElementsForPage, IsTagged, Průchod strukturou