PDFiumPas 文件

StructureCacheCapacity 屬性

元件: TPdf  ·  單元: PDFium
設定標籤式結構快取保留多少棵已剖析的頁面結構樹供重複使用

Syntax

property StructureCacheCapacity: Integer; // read and write, default 8

Description

讀取 StructureElementsForPage 時,會把頁面的標籤式結構樹剖析成受管理的快照。快取為文件的每一頁保留一個插槽,並以最近最少使用的順序保留已完成的樹,直到此容量上限,因此重複的無障礙檢查與結構走訪可以跳過原生的走訪

每棵保留的樹都以涵蓋其元素記錄、字串、識別碼陣列與屬性值的估算值來計量,並在共用的 CacheBudgetBytes 管控器中保留該估算額度

調降容量會收回最近最少使用的樹,並立即釋放其在管控器中保留的位元組

Remarks

把容量設為零會清空快取並停用保留,而透過 StructureElementsForPageReadStructureElements 的直接讀取仍可運作,只是每次都重新剖析

負數值會引發 EPdfError

未完成的走訪(例如因為達到深度、元素、屬性或期限限制而使 Status.CompletedFalse)會傳回給呼叫端,但永遠不會被快取

Example

Pdf.StructureCacheCapacity := 16;
Elements := Pdf.StructureElementsForPage[PageNumber];

See Also

StructureCacheCount, StructureCacheHitCount, StructureElementsForPage, CacheBudgetBytes, StructureTraversal