GetRangeSourceDataAvailability
إدارة المستندات، التحميل التدريجي، التشخيص
الوصف
تحدد ما إذا كان يملك PDF المحدد المدعوم بدوال رد نداء جميع البايتات اللازمة لمعالجة صفحة أو النموذج التفاعلي أو شبكة تبعيات كائن غير مباشر
الصيغة
Delphi
Function TPDFlib.GetRangeSourceDataAvailability(DataKind, Index: Integer;
Out Report: WideString): Integer;المعاملات
| DataKind | PDF_RANGE_DATA_PAGE, PDF_RANGE_DATA_FORM أو PDF_RANGE_DATA_OBJECT |
|---|---|
| Index | رقم صفحة يبدأ من 1، أو صفر لاستعلام النموذج، أو رقم كائن غير مباشر |
| Report | يستقبل تقرير JSON للتبعيات ونطاقات البايتات |
القيم المُرجعة
PDF_RANGE_DATA_ERROR (-1) | الوسائط أو المصدر أو بنية PDF غير صالحة؛ افحص LastErrorCode وReport |
|---|---|
PDF_RANGE_DATA_NOT_AVAILABLE (0) | نطاق مطلوب واحد على الأقل غير متوفر بعد |
PDF_RANGE_DATA_AVAILABLE (1) | شبكة التبعيات الكاملة متوفرة |
PDF_RANGE_DATA_NOT_PRESENT (2) | اكتمل استعلام النموذج والمستند بلا AcroForm |
حقول التقرير
scope, index, status, available | تحدد الاستعلام وتلخص نتيجته |
|---|---|
dependencyGraphComplete | تشير إلى ما إذا كانت كل تبعية قابلة للوصول قد فُحصت |
requestedObjects, resolvedObjects, traversedObjects | عدادات حسم الكائنات للتشخيص والجدولة |
requiredBytes, missingBytes | إجماليات البايتات منزوعة التكرار بعد دمج النطاقات المتداخلة |
requiredRanges, missingRanges | مصفوفات إزاحات المصدر start وend الشاملة |
error | خطأ بنية أو وسيطة اختياري مقروء آليًا |
ملاحظات
يتبع استعلام الصفحة مسار شجرة الصفحات الهدف فقط وموارد الصفحة وتيارات المحتوى والتعليقات التوضيحية وخصائص الصفحة الموروثةيجول استعلام النموذج تبعيات
يجول استعلام النموذج اعتماديات AcroForm ويتطلب أن يكون Index صفرًا
يبدأ استعلام الكائن من رقم كائن المرجع المتقاطع المزود ويتتبع المراجع غير المباشرة القابلة للوصول متجنبًا حواف العودة إلى الأب
المدايات المفقودة لا تقرأ أبدًا؛ والمدايات المبلغة متاحة قد تحلل وتضاف إلى ذاكرة المدايات البايتية
عدد الكائنات وعمق الاعتماديات محدودان لرفض البنى العدائية أو الدائرية بطريقة متوقعة