PDFium Delphi Component Docs

StructureElementsForPage egenskab

Komponent: TPdf  ·  Enhed: PDFium
Returnerer det cachede taggede strukturtræ for én side som et fladt array af element-records

Syntax

property StructureElementsForPage[PageNumber: Integer]: TPdfStructureElements; // read only

PageNumberInteger. Én-baseret sideindeks i det indlæste dokument
ResultTPdfStructureElements. Array af TPdfStructureElement-records i dokumentgennemløbsrækkefølge

Description

Den første adgang til en side parser det taggede strukturtræ med grænserne fra TPdfStructureReadOptions.Default — samme gennemløb, som ReadStructureElements bruger — og returnerer elementerne som administrerede records med niveau- og forælderlink, type- og titelstrenge, alternativ og aktuel tekst, sprog, marked content-identifikatorer, attributter, tabeldata og tilknyttede filreferencer

Hver adgang returnerer en dyb klon, så ændring af en returneret streng eller et array ikke kan ændre det cachede træ eller dokumentet. En side uden tagget struktur giver et tomt array

Fuldførte træer gemmes i den afgrænsede cache, der beskrives af StructureCacheCapacity, og måles mod CacheBudgetBytes, så gentagne læsninger af samme side koster én klon i stedet for ét nativt gennemløb

Remarks

Kald uden et aktivt dokument rejser EPdfError, og et PageNumber uden for én til PageCount rejser EPdfError med beskeden Incorrect page number

Den ikke-indekserede StructureElements-egenskab videresender den aktuelle side til dette opslag

Brug ReadStructureElements eller VisitStructureElements til brugerdefinerede grænser eller en streaming-visitor, der undgår at indsamle alle elementer

Example

Elements := Pdf.StructureElementsForPage[PageNumber];
for I := 0 to High(Elements) do
  if Elements[I].MarkedContentID >= 0 then
    LogMarkedContent(Elements[I].TypeName, Elements[I].Level);

See Also

StructureCacheCapacity, StructureCacheCount, StructureTraversal, StructureElements, TPdfView.StructureElements