GetRangeSourceDataAvailability

Quản lý tài liệu, Tải dần, Chẩn đoán

Mô tả

Xác định xem PDF đang chọn dựa trên callback có đủ các byte cần thiết để xử lý một trang, form tương tác hay một đồ thị phụ thuộc đối tượng gián tiếp hay không

Cú pháp

Delphi

Function TPDFlib.GetRangeSourceDataAvailability(DataKind, Index: Integer;
  Out Report: WideString): Integer;

Tham số

DataKind	`PDF_RANGE_DATA_PAGE`, `PDF_RANGE_DATA_FORM` hoặc `PDF_RANGE_DATA_OBJECT`
Index	Một số trang tính từ 1, số 0 cho truy vấn form, hoặc một số đối tượng gián tiếp
Report	Nhận một báo cáo phụ thuộc và byte-range dạng JSON

Giá trị trả về

`PDF_RANGE_DATA_ERROR` (-1)	Các đối số, nguồn hoặc cấu trúc PDF không hợp lệ; hãy kiểm tra `LastErrorCode` và `Report`
`PDF_RANGE_DATA_NOT_AVAILABLE` (0)	Còn ít nhất một vùng dữ liệu cần thiết chưa khả dụng
`PDF_RANGE_DATA_AVAILABLE` (1)	Toàn bộ đồ thị phụ thuộc đã khả dụng
`PDF_RANGE_DATA_NOT_PRESENT` (2)	Truy vấn form đã hoàn tất và tài liệu không có `AcroForm`

Các trường báo cáo

`scope`, `index`, `status`, `available`	Nhận diện truy vấn và tóm tắt kết quả của nó
`dependencyGraphComplete`	Cho biết mọi phụ thuộc with tới được đã được kiểm tra hay chưa
`requestedObjects`, `resolvedObjects`, `traversedObjects`	Các bộ đếm phân giải đối tượng phục vụ chẩn đoán và lập lịch
`requiredBytes`, `missingBytes`	Tổng byte đã khử trùng lặp sau khi các vùng chồng lấn được gộp
`requiredRanges`, `missingRanges`	Các mảng offset nguồn `start` và `end` tính cả hai đầu
`error`	Một lỗi cấu trúc hoặc đối số có thể đọc bằng máy, tùy chọn

Ghi chú

Truy vấn trang chỉ đi theo đường cây trang của trang đích, tài nguyên trang, content stream, chú thích và các thuộc tính trang thừa kếTruy vấn form đi qua các phụ thuộc

AcroForm và yêu cầu Index bằng 0Truy vấn đối tượng bắt đầu tại số đối tượng cross-reference được cung cấp và đi theo các tham chiếu gián tiếp with tới được trong khi tránh các cạnh quay về chaCác vùng dữ liệu thiếu không bao giờ bị đọc; các vùng được báo là khả dụng có thể được phân tích và thêm vào bộ nhớ đệm byte-rangeSố lượng đối tượng và độ sâu phụ thuộc bị giới hạn để từ chối các cấu trúc nguy hiểm hoặc có chu trình một cách dự đoán được

Truy vấn object bắt đầu từ số object cross-reference cung cấp và đi theo indirect reference tới được, tránh các cạnh quay về cha

Vùng thiếu không bao giờ bị đọc; vùng báo là khả dụng có thể được parse và thêm vào byte-range cache

Số object và độ sâu dependency bị giới hạn để từ chối cấu trúc độc hại hoặc tuần hoàn theo cách đoán được