PDFium Delphi Component Docs

GeneratePagedLayout metod

Component: TPdf  ·  Units: PDFium, FPdfLayout

Syntax

function GeneratePagedLayout(Layout: TPdfLayoutDocument; PagedPlan: TPdfLayoutPagedPlan; out Plan: TPdfLayoutPlan; AllowSignedDocument: Boolean = False): Boolean;

Description

Mäter och sidindelar layouten medan varje kommando serialiseras till den sökbara lagring som PagedPlan äger eller refererar till

Efter mätningen materialiserar den en sidkommandoarray i taget, emitterar sidan via samma nativa PDFium-sidobjekts-API:er som GenerateLayout, spolar ut den, frigör den lokala arrayen och fortsätter med nästa sida

Storage and cache

Använd en dedikerad TFileStream, TMemoryStream eller TPdfRandomAccessStore; strömmen måste stödja seek, läsning, skrivning, storleksändring och exklusiv användning under den sidindelade planens livstid

MaxCommandCount, MaxStorageBytes, MaxPageCommands och MaxSourceCount avvisar överdimensionerade planer, medan MaxCachedPages begränsar den interna LRU-cachen och får vara noll

CommandCount, StorageByteCount, cacheräknare och högsta beläggning ger mätbart beteende

Result

Plan.Commands är tom med flit; sidinställningar, sidantal, semantiska element, innehållsräknare, mätvärden och stabila totalsummor för sidreferenser finns fortfarande kvar

PagedPlan.MaterializePage kan återställa en komplett sida senare, inklusive brödtext plus separat skrivna sidhuvuds- och sidfotssegment

Limitations and safety

Metoden genererar en otaggad layout; använd GenerateTaggedLayout när en komplett kommandoplan i minnet och efterbearbetning av strukturträdet krävs

PDFium behåller det skapade dokumentet och dess nativa sidor tills spara eller stäng, så det här API:t begränsar materialiseringen av kommandon på hög nivå snarare än PDFium:s dokumentminne

Alla refererade käll-PDF:er och TPdfLayoutCachedNode-objekt måste överleva genereringen och senare materialisering, och signerade mål kräver uttrycklig behörighet

Misslyckad mätning eller emission återställer ofullständig kommandolagring och rullar tillbaka varje sida som anropet lade till

See Also

GenerateLayout, GenerateTaggedLayout, FPdfLayout, Arbetslagring med direktåtkomst