PDFium Delphi Component 文件

StructureCacheHitCount 属性

组件: TPdf  ·  单元: PDFium
统计由保留的页面结构树直接满足的结构元素读取次数

语法

property StructureCacheHitCount: Int64; // read only

说明

每当 StructureElementsForPageStructureElements 访问所涉及的页面已持有有效的缓存结构树时,该计数器递增一次。命中会按最近最少使用顺序刷新页面槽位、触碰共享缓存管理器中的条目,并返回保留快照的深拷贝

该值在 TPdf 实例的生命周期内累计且从不重置,因此不断上升的命中率表明反复的无障碍验证和结构遍历复用了同一次解析

备注

读取由原生 PDFium 页面访问所使用的渲染锁保护

容量变化、页面编辑、文档重新加载和清空都会保留该计数器;它们改变的是保留的内容,而不是已经发生的访问

将该值与 StructureCacheMissCount 配对即可计算有效命中率

示例

for I := 1 to PageCount do
  AuditStructure(Pdf.StructureElementsForPage[I]);
Ratio := Pdf.StructureCacheHitCount /
  (Pdf.StructureCacheHitCount + Pdf.StructureCacheMissCount);

参见

StructureCacheMissCount, StructureCacheCount, StructureCacheCapacity, StructureElementsForPage