GetRangeSourceDataAvailability
مدیریت سند، بارگذاری تدریجی، عیبیابی
توضیحات
تعیین میکند که آیا PDF متکی بر callback انتخابشده همه بایتهای لازم برای پردازش یک صفحه، فرم تعاملی یا گراف وابستگی شیء غیرمستقیم را دارد
نحو
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 | شماره صفحه یکمبنا، صفر برای پرسوجوی فرم، یا شماره یک شیء غیرمستقیم |
| 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 صفر باشدپرسوجوی شیء از شماره شیء ارجاع متقابل دادهشده آغاز میشود و ارجاعهای غیرمستقیم قابل دسترسی را دنبال میکند، بیآنکه لبههای برگشتی والد را طی کندمحدودههای غایب هرگز خوانده نمیشوند؛ محدودههای گزارششده در دسترس ممکن است تجزیه و به حافظه نهان محدوده بایتی افزوده شوندتعداد شیء و عمق وابستگی محدود شدهاند تا ساختارهای خرابکارانه یا چرخهای بهشکلی قابل پیشبینی رد شوند