GetRangeSourceDataAvailability
Gestion de documents, chargement progressif, diagnostic
Description
Détermine si le PDF sélectionné adossé à un callback possède tous les octets nécessaires pour traiter une page, le formulaire interactif ou un graphe de dépendances d'objets indirects
Syntaxe
Delphi
Function TPDFlib.GetRangeSourceDataAvailability(DataKind, Index: Integer;
Out Report: WideString): Integer;Paramètres
| DataKind | PDF_RANGE_DATA_PAGE, PDF_RANGE_DATA_FORM ou PDF_RANGE_DATA_OBJECT |
|---|---|
| Index | Un numéro de page à base 1, zéro pour la requête de formulaire, ou un numéro d'objet indirect |
| Report | Reçoit un rapport JSON des dépendances et des plages d'octets |
Valeurs de retour
PDF_RANGE_DATA_ERROR (-1) | Les arguments, la source ou la structure PDF sont invalides ; inspectez LastErrorCode et Report |
|---|---|
PDF_RANGE_DATA_NOT_AVAILABLE (0) | Au moins une plage requise n'est pas encore disponible |
PDF_RANGE_DATA_AVAILABLE (1) | Le graphe de dépendances complet est disponible |
PDF_RANGE_DATA_NOT_PRESENT (2) | La requête de formulaire s'est terminée et le document n'a pas d'AcroForm |
Champs du rapport
scope, index, status, available | Identifient la requête et résument son résultat |
|---|---|
dependencyGraphComplete | Indique si chaque dépendance joignable a été inspectée |
requestedObjects, resolvedObjects, traversedObjects | Compteurs de résolution d'objets pour le diagnostic et l'ordonnancement |
requiredBytes, missingBytes | Totaux d'octets dédupliqués après fusion des plages qui se chevauchent |
requiredRanges, missingRanges | Tableaux de décalages de source start et end inclusifs |
error | Une erreur structurelle ou d'argument facultative et lisible par machine |
Remarques
La requête de page ne suit que le chemin de l'arbre de pages cible, les ressources de page, les flux de contenu, les annotations et les attributs de page héritésLa requête de formulaire parcourt les dépendances
La requête de formulaire parcourt les dépendances AcroForm et exige que Index soit zéro
La requête d'objet démarre au numéro d'objet de référence croisée fourni et suit les références indirectes atteignables en évitant les arêtes de retour vers le parent
Les plages manquantes ne sont jamais lues ; les plages signalées comme disponibles peuvent être analysées et ajoutées au cache de plages d'octets
Le nombre d'objets et la profondeur de dépendances sont bornés pour rejeter de façon prévisible les structures hostiles ou cycliques