PDFium Delphi Component Docs

PageObjectsSnapshot الخاصية

المكوّن: TPdf  ·  الوحدة: PDFium
يعيد اللقطة المحدودة المخزنة مؤقتًا لكل كائن على صفحة واحدة بوصفها سجلات مُدارة

الصياغة

property PageObjectsSnapshot[PageNumber: Integer]: TPdfPageObjectsSnapshot; // read only

 

type TPdfPageObjectsSnapshot = record
  PageNumber: Integer;
  Width: Double;
  Height: Double;
  Status: TPdfPageObjectSnapshotStatus;
  Objects: TPdfPageObjectSnapshots;
end;

PageNumberعدد صحيح. فهرس الصفحة داخل المستند المحمَّل، وترقيمه يبدأ من الواحد
StatusTPdfPageObjectSnapshotStatus. علم الإكمال وعدّادات الكائنات التي مُرَّ عليها وأعلام الميزانيات التي بُلغت
Objectsسجلات لكل كائن تحمل النوع والحدود والتحويل والألوان ومصفوفات الشرطات ومقاطع المسار والقصّ وعلامات المحتوى والبيانات الوصفية للصورة والنص المحدود

الوصف

يلتقط أول وصول لصفحةٍ ما اللقطة بميزانيات TPdfPageObjectSnapshotOptions.Default؛ وتُقرأ الصفحة النشطة عبر مقابضها المحمَّلة، وتُحمَّل أي صفحة أخرى وتُغلق عابرةً دون تغيير PageNumber أو إطلاق OnPageChange

يعيد كل وصول نسخة عميقة، فلا يمكن لتغيير مصفوفات الشرطات المتداخلة أو معاملات العلامات أو مقاطع المسار أو مسارات القصّ أو المرشِّحات أو السلاسل أن يعدِّل البيانات المخزنة مؤقتًا أو المستند

تُحفظ اللقطات المكتملة في الذاكرة المؤقتة المحدودة التي يصفها PageObjectSnapshotCacheCapacity وتُقاس مقابل CacheBudgetBytes، وتعيد PageComplexity استخدام هذه الذاكرة لأنواع الكائنات وعدّادات المسارات وبكسلات الصور والشفافية

ملاحظات

يؤدي الاستدعاء دون مستند نشط إلى رفع EPdfError، ويؤدي PageNumber خارج المدى من الواحد حتى PageCount إلى رفع EPdfError بالرسالة Incorrect page number

استخدم ReadPageObjectsSnapshot لميزانيات التقاط مخصصة أو لتجاوز الذاكرة المؤقتة عمدًا

مثال

Snapshot := Pdf.PageObjectsSnapshot[PageNumber];
for I := 0 to High(Snapshot.Objects) do
  if Snapshot.Objects[I].ObjectType = otImage then
    LogImageObject(I);

انظر أيضًا

PageObjectSnapshotCacheCapacity, PageObjectSnapshotCacheCount, PageObjectSnapshots, PageObjectInfo, PageComplexity