PDFium Delphi Component Docs

свойство StructureCacheCapacity

Компонент: TPdf  ·  Модул: PDFium
Задава колко разчетени дърва на структурата на страници задържа за преизползване кешът на тагнатата структура

Синтаксис

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

Описание

Четенето на StructureElementsForPage разчета тагнатото дърво на структурата на страница в управлявана снимка. Кешът държи по един слот за страница на документа и задържа завършените дърва в LRU ред до този капацитет, така че повтарящите се проверки за достъпност и обхождания на структурата прескачат нативното минаване

Всяко задържано дърво се измерва с оценка, обхващаща записите на елементите, низовете, масивите с идентификатори и стойностите на атрибутите, и резервира тази оценка в споделения управител CacheBudgetBytes

Намаляването на капацитета изхвърля най-малко наскоро използваните дърва и незабавно освобождава техните байтове в управителя

Забележки

Задаването на капацитет нула изчиства кеша и изключва задържането, докато директните четения чрез StructureElementsForPage и ReadStructureElements продължават да работят и просто разчитат наново всеки път

Отрицателните стойности вдигат EPdfError

Непълно обхождане — такова, чийто Status.Completed е False, защото е достигнат лимит за дълбочина, елементи, атрибути или краен срок — се връща на извикващия, но никога не се кешира

Пример

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

Виж също

StructureCacheCount, StructureCacheHitCount, StructureElementsForPage, CacheBudgetBytes, StructureTraversal