PDFium Delphi Component Docs

StructureCacheCapacity ویژگی

کامپوننت: TPdf  ·  واحد: PDFium
تعیین می‌کند کش ساختار تگ‌شده چند درخت ساختار صفحهٔ تجزیه‌شده را برای استفادهٔ دوباره نگه دارد

Syntax

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

Description

خواندن StructureElementsForPage درخت ساختار تگ‌شدهٔ یک صفحه را به اسنپ‌شات مدیریت‌شده‌ای تجزیه می‌کند. کش به‌ازای هر صفحهٔ سند یک اسلات نگه می‌دارد و درخت‌های کامل‌شده را تا همین ظرفیت به ترتیب کم‌استفاده‌ترین (LRU) نگاه می‌دارد تا بررسی‌های مکرر دسترس‌پذیری و پیمایش‌های ساختار از پیمایش نیتیو بگذرند

هر درخت نگه‌داشته‌شده با برآوردی پوشانندهٔ رکوردهای عناصر، رشته‌ها، آرایه‌های شناسه و مقادیر ویژگی اندازه‌گیری می‌شود و همین برآورد را در گردانندهٔ مشترک CacheBudgetBytes رزرو می‌کند

کاهش ظرفیت کم‌استفاده‌ترین درخت‌ها را اخراج می‌کند و بایت‌های گرداننده‌شان را بلافاصله آزاد می‌سازد

Remarks

صفر کردن ظرفیت کش را خالی و نگه‌داشتن را از کار می‌اندازد؛ خواندن‌های مستقیم از طریق StructureElementsForPage و ReadStructureElements به کار خود ادامه می‌دهند و هر بار به‌سادگی دوباره تجزیه می‌کنند

مقادیر منفی EPdfError برپا می‌کنند

پیمایش ناقص — آن‌که Status.Completed اش به‌سبب برخورد با کران عمق، عنصر، ویژگی یا مهلت False است — به فراخوان برمی‌گردد اما هرگز کش نمی‌شود

Example

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

See Also

StructureCacheCount, StructureCacheHitCount, StructureElementsForPage, CacheBudgetBytes, StructureTraversal