PDFium Delphi Component Docs

StructureCacheMissCount Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Zählt Structure-Element-Lesezugriffe, die den Seitenstruktur baum neu parsen mussten

Syntax

property StructureCacheMissCount: Int64; // read only

Beschreibung

Der Zähler erhöht sich einmal für jeden StructureElementsForPage- oder StructureElements-Zugriff, dessen Seitenslot nicht gültig ist, was beim ersten Zugriff, nachdem der Eintrag durch Kapazitätsdruck verdrängt wurde, nach einer Seitenbearbeitung und nach einem Dokument-Neuladen, das das Slot-Array in der Größe änderte, der Fall ist

Ein Fehlgriff löst eine frische Traversierung mit TPdfStructureReadOptions.Default aus. Das Ergebnis wird nur gespeichert, wenn die Kapazität positiv und die Traversierung abgeschlossen ist; andernfalls wiederholt sich das Parsen beim nächsten Zugriff

Der Wert ist kumulativ über die Lebensdauer der TPdf-Instanz und wird nie zurückgesetzt

Hinweise

Das Lesen wird durch den Render-Lock geschützt, den auch der native PDFium-Seitenzugriff verwendet

Lookups werden nie abgewiesen: Bei deaktivierter Aufbewahrung ist jeder Zugriff ein Fehlgriff, der dennoch die frisch geparsten Elemente zurückgibt

Kombinieren Sie den Wert mit StructureCacheHitCount, um die effektive Fehlgriffquote zu berechnen

Beispiel

Pdf.StructureCacheCapacity := 0;
Elements := Pdf.StructureElementsForPage[1];
Elements := Pdf.StructureElementsForPage[1];
// StructureCacheMissCount advanced twice, HitCount stayed unchanged

Siehe auch

StructureCacheHitCount, StructureCacheCount, StructureCacheCapacity, StructureElementsForPage