PDFium Delphi Component Docs

คุณสมบัติ TextSnapshotCacheCapacity

Component: TPdf  ·  Unit: PDFium
กำหนดว่าจะให้ text snapshot cache เก็บ text page snapshot ฉบับสมบูรณ์ไว้กี่รายการเพื่อใช้ซ้ำ

Syntax

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

Description

การอ่าน TextPageSnapshot จะเก็บข้อความของหน้า record ต่ออักขระ และ record ต่อ text object ด้วยงบ default cache จะจอง slot ละหนึ่งหน้าของเอกสาร และเก็บ snapshot ที่สมบูรณ์ไว้ตามลำดับ least-recently-used จนถึง capacity นี้ การดึงข้อความซ้ำ ๆ การอ่าน structured text และการไล่ตามลำดับการอ่าน จึงใช้ผลการเก็บเพียงชุดเดียวร่วมกัน

snapshot ที่เก็บไว้แต่ละชุดถูกวัดด้วยค่าประมาณการที่ครอบคลุม record ของ snapshot ข้อความของหน้า อาร์เรย์อักขระและ text object และสตริงชื่อฟอนต์ แล้วจองงบนั้นไว้ใน governor CacheBudgetBytes ที่ใช้ร่วมกัน

การลด capacity จะไล่ snapshot ที่ไม่ได้ใช้นานสุดออก และคืนไบต์ของมันให้ governor ทันที

Remarks

ตั้ง capacity เป็นศูนย์จะล้าง cache และปิดการเก็บซ้ำ แต่การอ่านแบบมีขอบเขตผ่าน TextPageSnapshot และ ReadTextPageSnapshot ยังใช้ได้ปกติ เพียงแต่เก็บใหม่ทุกครั้ง

ค่าติดลบทำให้เกิด EPdfError

การเก็บที่ไม่สมบูรณ์ ซึ่ง Status.Completed เป็น False เพราะไปชนงบอักขระ text object หรือชื่อฟอนต์ จะถูกคืนให้ผู้เรียก แต่จะไม่ถูกเก็บลง cache เด็ดขาด

Example

Pdf.TextSnapshotCacheCapacity := 16;
Snapshot := Pdf.TextPageSnapshot[PageNumber];
LogSnapshotText(Snapshot.Text);

See Also

TextSnapshotCacheCount, TextSnapshotCacheHitCount, TextPageSnapshot, CacheBudgetBytes, TextPageSnapshots